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CHAPTER 1. INTRODUCTION 



The Machine Operations Manual is one of a set of manuals prepared to 
define the various functions and personnel relationships involved in the 
implementation and system operation of Information Management System/360 
(IMS/360) . The other manuals in the set are: 

IMS/360 Application Description Manual (GH20-052U) 

IMS/360 Program Description Manual (SH20-0634) 

IMS/360 Operations Manual, Volume I - Systems Operation (SH20-0635) 

IMS/360 System Manual, Volume I - Program Logic (LY20-0U31) 

IMS/360 System Manual, Volume II - Flowcharts (LY20-0a32) 

This introductory chapter restates some of the same information found 
in the introductory chapter of the Program Description and Systems 
Operations Manuals. 

The necessity for these manuals became apparent during the design 
phase of the IMS/360. The usual mix of data processing personnel 
normally provides for application programming, system programming, and 
machine operations functions. With the introduction of IMS/360, 
however, the need for a fourth function, a coordinating force in 
implementing, administering, and maintaining the system, became 
apparent. The function is the "heart" of the IMS/360 system and has 
been designated the "Systems Operation" function. The Systems Operation 
function and its interface with other functions are delineated in this 
manual (see Figure 1). 

An understanding of the following is a prerequisite for a thorough 
comprehension of this manual: 

IMS/360 Application Description Manual (GH20-0524) 

IMS/360 Program Description Manual (SH20-063U) 

OS/360 Supervisor and Data Management Services (GC28-6646) 

OS/360 Operator's Guide (GC28-65U0) 
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Figure 1. IMS/360 functional relationships 



MACHINE OPERATIONS FUNCTION 

In addition to the usual operational assignments, the Machine 
Operations function shall be responsible for: 

• All master terminal capabilities in accordance with established 
procedures, with especially prepared instructions to cover 
extraordinary happenings 

• Assisting teirminal operators at remote terminals in the initial 
diagnoses of apparent problems, be they concerned with the remote 
terminal, the connecting communication line, the central hardware, 
the central software, or message processing application programs. 
After the initial diagnoses, the Machine Operations function should 
have accumulated sufficient information to determine whose 
assistance is required and to intelligently describe the problem, 
and will be able to assist in determining the degree of emergency 
sustained. 



SYSTEMS OPERATION FUNCTION 

The function of Systems Operation is the following: 

• Responsibility for control over and approval of all new data base 
designs and descriptive control blocks 

• Maintenance of the data bases under Data Language/I, including all 
control, allocation, and data base creation and reorganization 



Maintenance of a catalog of programs "certified" to operate as 
message processing programs under IMS/360, including related 
documentation, processing priorities, transaction codes^, control 
blocks, etc. 

Responsibility to provide the capability for reconstruction and 
recovery of IMS/360 and its associated data bases when routine • 
procedures known and understood by the Machine Operations function 
are insufficient for such recovery and reconstruction. The Systems 
Operation function also has the responsibility to be available to 
participate in such extraordinary operations whenever they are 
required. 

Responsibility for the utility programs which process the IMS/360 
system log tapes and for causing these programs to process the log 
tapes and to yield accounting information, machine operations 
statistics, usage and data base statistics, and certain management 
reports on utilization and errors incurred. The function shall also 
have the responsibility for auditing these reports for quality and 
for assigning certain reports to other functions for analysis, as 
appropriate . 

Accounting and billing for IMS/360 and message programs and a 
background batch program in the IMS/360 environment are provided as 
a part of the Systems Operation function. Statistics from the 
system log tape reflecting activity by system, transaction type, 
terminal, line, etc. are also distributed. 

Responsibility for IMS/360 system definition and modification 

Maintenance of all IMS/360 documentation 

Configuration planning, for all purposes, of new applications so 
that communication lines, consoles, and software are available to 
support approved applications 



SYSTEMS PROGRAMMING FUNCTION 

The functions of Systems Programming encompass the following: 

• Assistance and participation in the hardware installation, test, and 
initial operations of any new equipment or changed configurations 

• Consultation with lMS/360 application programmers in conjunction 
with the Systems Operation function to assist in the integration of 
applications with IMS/360 

• Software maintenance and improvement of IMS/360 utility programs and 
modifications to Operating System/360 



APPLICATION PROGRAMMING FUNCTION 

The Systems Operation function provides for applications planning, 
implementation, and audit. The application programming function must 
consider the following in its analysis of a proposed application: 

• Configuration and storage device requirements for anticipated 
applications 

• Data base structuring, storage device cost/performance tradeoffs, 
and sharing of mutual data with existing data bases 



• Program structuring, core limits, duration of execution, overlay 
structure, and program chaining 

• Message formats and length, transaction types, priorities, 
passwords, and logical terminal names 

• Schedule of data base checkpoints and checkpoint cost versus 
reconstruction cost 

• Schedule of data base dumps and reorganization 

MACHINE OPERATIONS CHECKLIST 

The following Machine Operations checklist provides a further aid to 
understanding the tasks of the Machine Operations function. 

The items or tasks in the checklist are enumerated in detail in 
Chapters 3, 4, 5, and 6. Chapter 7 describes the possible messages and 
codes of IMS/360. 

This checklist is not to be considered chronological, nor are the 
checks to be accomplished in the sequence given. It is directed toward 
the information needed for control and maintenance of the IMS/360 
system. 

The following is an explanation of the columns of the checklist: 

Column 1 is the item under consideration. 

Column 2 is the name of the function that has the responsibility for 
providing the information. 

Column 3 lists the manuals that provide more details about the 
particular item. 

PDM = Program Description Manual. 
SOM = Systems Operation Manual. 
MOM = Machine Operations Manual. 
SM = System Manual. 

RESPONSIBILITY DETAIL IN 
ITEM IN PROVIDING WHICH MANUAL 

1. Has Type I programming Sys. Oper. Func. SOM 
system been selected? 

(PCP, MVT, or MFT-II) 

2. Will all types of IMS/360 Sys. Oper. Func. PDM,. SOM 
processing regions be 

standard? 

3- How many regions or Sys. Oper. Func. PDM, SOM 
partitions are to be 
initiated normally? 

H. Coordinate terminal and Sys. Oper. Func. PDM, SOM, 
hardware network Mach. Oper. Func. MOM 

installation and 
operation. 



ITEM 



RESPONSIBILITY 
IN PROVIDING 



DETAIL IN 
WHICH MANUAL 



a- Keep necessary manual 
records of network. 
If dialup, telephone 
numbers . 



Mach . Oper . Func , 



MOM 



5. Keep a valid list of 

transaction codes, their 
relationship to the 
application program, 
and which data base. 

a. List their priority 
and whether it is 
allowed to be changed 
at any time. 



6. 



Sys. Oper. Func. 
from Appl. Prog. 
Func. 



Sys. Oper. Func. 
from Appl. Prog. 
Func. 



What transaction codes Sys. Oper. Func. 
are allowed single from Appl. Prog, 
or multiple line entry? Func. 



PDM, SOM, 
MOM 



PDM, SOM, 
MOM 



PDM, SOM, 
MOM 



Follow through on the 

plan of the residence 

of MACLIB, RESLIB, PGMLIB, 

PSBLIB, DBDLIB, and 

PROCLIB. 



Work in conjunction SOM, MOM, 
with Sys. Oper. SM 
Func. and Sys. 
Programming Func. 



7. Has the proper setup been 
made with regard to 
specifying the data sets,, 
volumes, and I/O devices 
required for running 
IMS/360 System Definition 
utility? 

8. In readying IMS/360, have 
the numbers been 
specified for the 
Operating System/360 
SVC*s (Type 1 and 2) and 
have they been r el ink- 
edited into the Operating 
System/360 nucleus? 

9. Has the OSAM channel end 
appendage load module 
been moved to the 
SYSl.SVCLIB? 



Sys . Oper . Func . 



SOM, MOM 
SM 



Sys. Oper. Func. 



SOM, MOM, 
SM 



Sys. Oper. Func. 



SOM, MOM, 
SM 



10. Has the sequence list of 
events for readying 
IMS/360 been checked? 
(Chapter 5, MOM) 

11, Has the plan been 
specified for the 
statistics reports 

from the IMS/360 system? 

a. Has the card deck been 
specified from which 
to execute the IMS/360 
Statistics Utility? 



Work in conjunction SOM, MOM 

with Sys. Oper. 

Func. 



Sys. Oper. Func. SOM, MOM 



Sys. Oper. Func. SOM, MOM 



ITEM 

12. Do you know the location 
of remote terminals, the 
telephone number closest 
to that location, and the 
lead remote terminal 
operator's name? 

13. What is status of each 
remote terminal 
operator's training? 

m. Concerning the Master 

Terminal and the Machine 
operator function: 



RESPONSIBILITY 
IN PROVIDING 

Mach. Oper. Func. 



Mach. Oper. Func, 



Mach. Oper. Func. 



Has the Master Terminal Mach. Oper. Func. 

operator received 

adequate training and 

kept current with 

changes? 



b. 



c. 



Have the instructions 
to the MT operator 
about the types of 
checkpoints been 
delineated? 

Have the instructions 
to the MT operator 
about the restart 
procedures been 
delineated? 



Mach. Oper. Func. 



Mach. Oper. Func. 



DETAIL IN 
WHICH MANUAL 

MOM 



MOM 



MOM, SOM 



MOM, SOM 



MOM, SOM 



MOM, SOM 



d. Has an operating plan 
been worked out 
between the MT 
operator and the 
computer console 
operator for the 
system log tapes? 

e. Are the types of 
system shutdown 
procedures described? 

f . Have the instructions 
for alternate master 
terminals been 
delineated? 

g. Is the remote terminal 
trouble procedure 
adequate? 

h. Have adequate IPL 
instructions been 
delineated? 



Mach. Oper. Func. 



MOM, SOM 



Mach. Oper. Func. 



Mach. Oper. Func. 



Mach. Oper . Func . 



Mach. Oper. Func. 



MOM, SOM 



MOM, SOM 



MOM., SOM 



MOM, SOM 



ITEM 



RESPONSIBILITY 
IN PROVIDING 



i. Has a group of coiranand Mach. Oper. Func. 
language verbs been 
restricted to entry 
from the master 
terminal? 



Mach. Oper. Func. 



Keep necessary records 
available to the 
master terminal 
operator concerning 
the security program 
changes; that is, the 
date from security 
change, list of 
secured items, etc. 



k. Have adequate instruc- Mach. Oper. Func. 
tions been delineated 
for recovery from data 
base failure? 



Mach. Oper. Func. 



15. Are there adequate proce- 
dures for both the master 
terminal operator and the 
System/360 operator for 
handling the IMS/360 log 
tapes? 



16. Are procedures delineated Mach, Oper. 
for remote terminal start- 
up and shutdown? 



Func. 



17. Have the procedures 
been delineated and 
the JCL been available 
for these IMS/360 
Utilities : 

a. Statistics Report 

b. DBD Generation 

c. PSB Generation 

d. Security Maintenance 

e. System Definition 

18. Make necessary 
coordination to handle 
system ABENDS, error 
conditions, and trouble 
reports . 

19. Have schedules been 
planned for system 
checkpoint, data 
base dumps, and 
reorganization? 



Mach. Oper. Func. 



Mach.. Oper. Func. 
Mach. Oper. Func, 
Mach. Oper. Func, 
Mach. Oper. Func, 
Mach. Oper. Func. 
Sys. Oper. Func. 



Sys,. Oper. Func 



DETAIL IN 
WHICH MANUAL 

MOM, SOM 



MOM, SOM 



MOM, SOM 



MOM, SOM 



MOM, SOM 



MOM, SOM 



MOM, SOM 

MOM, SOM 

MOM, SOM 

MOM., SOM 

MOM., SOM 

PDM, SOM, 
MOM 



SOM, MOM 



CHAPTER 2. IMS/360 AND MACHINE OPERATIONS 



Information Management System/360 (IMS/360) is designed to make 
possible the creation and maintenance of medium to large common data 
bases with many applications. It allows both online message processing 
and conventional batch processing either individually or simultaneously. 
IMS/360 operates under the control and facilities of Operating 
System/360 with Multiprogramming with a Fixed Number of Tasks (MFT) or 
Multiprogramming with a Variable Number of Tasks (MVT) . 

The IMS/360 user should realize that a complete, thorough 
understanding of Operating System/360 operation is prerequisite to a 
like understanding of the information in this manual; This manual is 
provided as an aid to proper, accurate processing under Operating 
System/360. A review of IBM System/360 Operating System , Operator" s 
Guide (GC28-65U0) is recommended. 

GENERAL DESCRIPTION OF IMS/360 

IMS/360 is a set of control program modules designed to operate under 
the control of and within the framework of Operating System/360. The 
intent is to give the user of Operating System/360 the ability to 
construct large data bases and to interface with the data in an 
efficient teleprocessing manner. To gain maximum utilization of the 
resources of IMS/360, a multiprogramming environment is required and is 
obtained through the facilities of Operating System/360 with 
Multiprogramming with a Fixed Number of Tasks (MFT) or Multiprogramming 
with a Variable Number of Tasks (MVT) . 

At initial program load (IPL) time (see Figure 2) , the Operating 
System/360 nucleus is brought into core storage to become the foundation 
of this multiprogramming environment. The highest priority region of 
Operating System/360 is used for the IMS/360 resident control program. 
The remainder of the available core storage is divided into message 
regions and batch regions, depending upon user requirements. 



OS/360 
NUCLEUS 



REGION I REGION 1 | REGION 2 | REGION 3 

IMS I MESSAGE | MESSAGE | BATCH 

CONTROL I PROCESSING! PROCESSING! PROCESSING 

PROGRAM II I 






Figure 2. Operating System/3 60- IMS/3 60 multiprogramming environment 

The Operating System/360 nucleus and its resident extensions provide 
the nucleus resident service modules, resident access methods, SVC's, 
etc. that are required when running in an IMS/360 environment. 

The IMS/360 control program region includes all the resident control 
modules and facilities available to the application program. 

IMS/360 was developed to improve the ability of the computer user to 
operate teleprocessing and/or batch-type application systems. 



TELEPROCESSING AND BATCH PROCESSING 

In batch processing, single transactions are accumulated as a batch 
and processed periodically against the data base. The use of batch 
processing should depend on how current the user's data needs to be and 
on the costs of alternate forms of processing. 

Under teleprocessing, remote terminals provide the ability to enter 
transactions as "messages", allowing inquiry and update capability to 
the data base. Data bases used for teleprocessing may also be used for 
batch processing programs for functions like the production of reports. 

DATA BASE 

With the introduction of the "data base" concept, users can share 
common data and be assured that that data is current. 

A data base is considered to be a nonredundant collection of 
interrelated data items processable by one or more applications (see 
Figure 3). 




Figure 3. Application data integration - data base concepts 

As an example, a company with an application for release of 
engineering parts data may combine some of its data with a file of 
manufacturing parts release information. Later, there may be the need 
for additional data to be added on assembly installation. The point is 
that, even with the addition of the third application, the data and 
programs of the first two applications need not change. This is a basic 
concept of the term data base. 

This example also illustrates the flexibility of the data 
organization. Data may be added to a new or existing application 
without the need for modifying existing programs. Obviously, this will 
result in a savings on storage and processing costs. 

The functions of data base definition, creation, access, and 
maintenance are accomplished through an IMS/360 facility called Data 
Language/I. This facility may be used in either the batch or the 
teleprocessing envi ronment . 

DATA LANGUAGE/I 

The full data base facilities of Data Language/I can be used in the 
IMS/360 batch processing or teleprocessing environment. Data Language/I 
gives users the ability to adapt IMS/360 to the data requirements of 
their own applications. It can be used to assist in the creation and 
maintenance of data, to promote the integration or sharing of data, and 



to reduce application program maintenance caused by changes in the data 
requirements of the application user. 

DATA COMMUNICATION FACILITY 

The data communication facility of IMS/360 provides support of IBM 
1050, or 2260, or 2740 communication terminals for message input and 
output, with one terminal (1050, 2740) acting as the "master terminal" 
of the system. This provides a control center for all message 
processing. 

MESSAGE SCHEDULER 

A message scheduler initiates message processing when required 
resources become available- 

CHECKPOINT AND RESTART FACILITIES 

Checkpoint and restart facilities provide the ability to check system 
status and to restart at explicit intervals. Checkpoint and restart are 
available to the extent that queuing functions and data base 
modifications are logged. 

PROCESSING REGIONS AND SYSTEM FLOW 

Four types of Operating System/360 regions or partitions represent 
the system structure of IMS/360: Types 0, 1, 2, and 3. The processing 
regions and system flow are detailed in Chapter 3 of the IMS/360 
Operations Manual, Volume I - Systems Operation and Chapter 5 of the 
IMS/360 Application Description Manual . 

TYPE PROCESSING REGION 

Processing region Type is the IMS/360 control program and is 
created at system definition time. Once operative, the Type region 
uses the Operating System/360 multiple wait capability. 

TYPE 1 PROCESSING REGION 

Any IMS/360 message region is considered to be an IMS/360 Type 1 
processing region. Its existence is established by entering the job 
control statements (JCL) for an Operating System/360 job representing 
this region into the input job stream (SYSIN) or via a command from the 
IMS/360 master terminal. The Operating System job scheduler establishes 
the existence of the region and loads into it the IMS/360 region 
controller. It is the responsibility of the region controller to keep 
the message region under the control of IMS/360. In a sense, it 
establishes an endless Operating System/360 job, which maintains control 
of the message region for an indefinite period of time. The JCL 
statement may be entered into the Operating System/360 job stream as 
many times as desired to establish as many message regions as desired. 

TYPE 2 PROCESSING REGION 

After Operating System/360 initiates the IMS/360 regions associated 
with teleprocessing, a Type 2 (batch) processing region can be 
established. Programs operating in this region that reference 
teleprocessing (online) data bases enter the system as Operating 

10 



System/360 jobs and are scheduled and loaded by the Operating System job 
scheduler. A batch program utilizing a teleprocessing data base and a 
message processing program using that same teleprocessing data base can 
concurrently operate against that data base with only a GET function 
(read-only) processing option. A program operating in a Type 2 
processing region can use all the facilities of Operating System/360 
data management. A program operating in a Type 2 processing region 
cannot access an IMS/360 nonteleprocessing data base. 



TYPE 3 PROCESSING REGION 

Type 3 batch programs also enter the system as Operating System/360 
jobs, are scheduled and loaded by the Operating System job scheduler, 
and may create, reference or modify IMS/360 data bases not concurrently 
being used for teleprocessing. A program in a Type 3 processing region 
can use all the facilities of Operating System/360 data management. 

HISTORY 

Until IMS/360 it was typical for data files to be designed for 
individual applications. Each file was designed with its own storage 
location in the computer, on tape, or on disk. It is obvious that some 
of these files would hold information much like the information in some 
of the other files and that the same information would often be kept in 
more than one file. This often resulted in the common data not being 
maintained current in all files, since some files would necessarily be 
used less frequently than others. And, of course, the cost of data 
processing would be increased because of the extra storage required for 
this duplicate data and its maintenance. IMS/360 provides several 
features which assist in establishing, changing, and expanding 
application systems and information files. Applications may now be 
designed to interface with information files, from remote, 
typewriter- like terminals. 



THE MASTER TERMINAL 

Just as the operational "hub" of Operating System/360 is the 
System/360 console, the operational hub of the IMS/360 system is the 
user's master terminal. The importance of the IMS/360 master terminal 
cannot be overstressed. The master terminal is an IBM 1050 or 2740 
communications terminal, which controls IMS/360 communications, message 
scheduling, and data base operation.. It is used for checkpointing and 
restarting the system, for monitoring the system, and for altering 
operation of the system. An alternate master terminal may be defined,, 
and, at the user's option, the Systera/360 console may be so designated. 

In effect, there are always two master terminals, since the 
System/360 console can serve as an alternate master terminal and may be 
used as such should the master terminal malfunction. When it is serving 
as the master terminal, all master terminal commands, except /DISPLAY, 
/RDISPLAY, /TEST, /EXCLUSIVE, . /END, and /BROADCAST, can be issued from 
the computer console. It is not recommended that the System/360 console 
be normally used as the master terminal. It should be used only in 
emergencies . 

Although IMS/360 supports IBM 2740 and 1050 terminals connected to 
leased communication lines or common carrier switched communication 
facilities, the master terminal must be connected through a leased or 
nonswitched communication line. The 2260 Display Station cannot be used 
as a master terminal. 



11 



THE COMMAND LANGUAGE 

A master terminal language allows the master terminal operator to 
interrogate, alter, or control the entire IMS/360 system. All security 
capabilities of IMS/360 are also controlled by means of this language to 
assist in maintaining proper access to and the integrity of information. 

A list of terminal commands follows. Proper entry of these commands 
is essential to the success of the Machine Operations function. Details 
of all the commands are found in Chapters 3 and U. (A review of the 
appropriate SRL Operator's Guide for the terminal being operated would 
be helpful.) 



LIST OF ALL TERMINAL COMMANDS 



COMMAND NAME 


DETAILS 


FOUND 


COMMAND NAME 


DETAILS 


FOUND 




Chap 


3| 


Chap 4 


Chap 


3| 


Chap 4 


ASSIGN 


X 






lAM 






X 


BROADCAST 






X 


LOCK 








CANCEL 






X 


LOG 






X 


CHANGE 


X 






NRESTART 


X 






CHECKPOINT 


X 






PSTOP 


X 






DBDUMP 


X 






PURGE 


X 






DBLOG 


X 






RDI SPLAY 






X 


DBNOLOG 


X 






RESET 






X 


DBRECOVERY 


X 






SET 






X 


DELETE 


X 






START 


X 






DISPLAY 


X 














END 






X 


STOP 


X 






ERESTART 


X 






TEST 






X 


EXCLUSIVE 






X 


UNLOCK 






X 



V 



PHYSICAL AND LOGICAL TERMINALS 



IMS/360 conceptually makes use of two types of terminals: physical 
and logical. Physical terminals are the hardware devices used to enter 
or record messages being sent or received over communication lines. 
Logical terminals (LTERM) are primarily names which are related to 
physical terminals (PTERM) or their components. It is the logical 
terminal that is referenced in the construction and transmission of 
messages. There may be one or more logical terminals associated with a 
particular physical terminal. This association of logical terminals to 
a physical terminal is created by the Systems Operation function during 
IMS/360 system definition. Each logical terminal associated with a 
physical terminal may have different security restrictions. 

References to physical terminals in the following discussions refer 
to the relative physical terminal on the line; that is, the first 
physical terminal on any line is always physical terminal 1 (PTERMl) ; 
the second, physical terminal 2 (PTERM2); etc. 

In a switched network environment, a further distinction is made 
between logical terminals that are normally connected to a physical line 
in idle, answering, or calling status, and logical terminals that may be 
specified for attachment to an answered switched line. The former type 
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of logical terminal is called a line logical terminal, and the latter is 
called a subpool logical terminal. 

Remote switched network terminals must call IMS/360 line groups that 
correspond to the type of terminal and feature of the calling terminal. 



12.1 



12.2 



Subsequent to connection of the switched line call, the sign-on 
procedure will accomplish the connection of the specified logical 
terminals to the physical line. Since there are no physical attribute 
specifications in the subpool logical terminal, sign-on may be specified 
for more than one type of physical terminal. 

For more details, see Chapter 3 in the IMS/360 Operations Manual, 
Volume I - Systems Operation. 

REMOTE TERMINALS AND THEIR LANGUAGE 

The remote terminal command language is detailed in Chapter 4 of this 
manual. Note that all commands from remote terminals are also available 
for use by the master terminal. Of course, the entry of remote terminal 
commands can be regulated through the use of passwords. The remote 
terminal command applies only to the terminal from which it is entered. 

INITIAL PROGRAM LOADING 

Initial program load (IPL) is a procedure that is carried out at such 
times as the beginning of a shift or after scheduled maintenance. It 
must be accomplished for the Operating System/360 before IMS/360 can be 
initiated as jobs under control of Operating System/360. The details 
for the initialization, execution, and termination of IMS/360 under 
Operating System/360 are provided in Chapter 5 of this manual. 

MESSAGE PROCESSING REGION ABENDS 

The message processing regions (MVT) or partitions (MET) , of IMS/360 
perform all message processing. An application program for message 
processing resides and executes within a message processing region or 
partition. When operating with Operating System/360 MVT, a message 
processing program operates as an Operating System/360 task subordinate 
to the task that controls the message processing region. When operating 
with Operating System/360 MFT, hold a message processing program 
operates as part of the same task as the IMS/360 modules that control 
the message partition. 

If the application-message processing TRENDS during execution, the 
state in which the message processing region or partition is left 
depends upon whether MFT or MVT is being used. If MVT is being used, 
the Operating System/360 subtask containing a message processing program 
is ABENDed, but the Operating System/360 task containing the IMS/360 
modules for message region control continues to execute. (A subtask is 
a task that is created by another task by means of the ATTACH 
macro- instruct ion. ) The master terminal operator is notified about the 
ABENDed message processing program and the transaction code it was 
processing at the time of ABEND. The program and transaction code are 
stopped and are unavailable for processing until a /START command is 
issued from the master terminal. Since the message region still exists, 
the transaction type of highest priority in the input queue is scheduled 
for processing in the message region. 

If MFT is being used and the message processing program ABENDS, the 
entire Operating System/360 job representing the message partition 
terminates. Another Operating System/360 job representing an IMS/360 
message processing region must be initiated immediately in the same 
partition. This can be accomplished through the job class scheduling 
function of Operating System/360. 

The problems of message region ABENDS should be thoroughly considered 
with the user's Systems Operation function. 
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LOG TAPE LABELS 

The IMS/360 system log is an Operating Systein/360 QSAM tape data set 
with. variable length records. This data set has standard labels. If a 
failure occurs that terminates not only IMS/360 but Operating System/360 
as well, a trailer tape label is not written on the IMS/360 system log. 
The normal operating procedure is to manually tape-mark the tape from 
the tape control unit. However, no trailer label is written. Before 
this log tape can be used for restart of IMS/360 or data base recovery, 
a trailer label must be supplied by the user of IMS/360. This can be 
accomplished through a batch job execution to copy the log to another 
tape. When the manually applied tape-mark on the log is read, the 
user-provided batch job will ABEND, but Operating System/360 will write 
a trailer label on the copied-to tape. The Basic Sequential Access 
Method with one buffer for both input log and output tape should be used 
in the user-provided program. See the Systems Operation function for 
assistance in this area. 
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CHAPTER 3. IMS/360 MASTER TERMINAL COMMANDS 



This chapter supplements the quick-reference checklist provided in 
Chapter 1 and emphasizes the master terminal and terminal command 
responsibilities of the Machine Operations function when operating the 
Information Management System/360. 

Selection of a qualified master terminal operator and an equally 
capable System/360 console operator is extremely important. The Systems 
Operation fimction should provide the training, with hands-on time, for" 
each operator. The importance of these two operators cannot be 
overstressed. It is recommended that this manual not be used as final 
procedure within the user's installation. IMS/360 has built into it a 
great flexibility; therefore, each individual installation will have its 
preference for proper procedures. As an example, not all the commands 
are to be used. Each installation will want only certain commands used 
from the remote terminal and others from the master terminal. It is 
recommended that the user prepare his own more detailed written 
operating procedure. 

The proximity of the master terminal of IMS/360 and the System/360 
computer console must be considered with regard to security, ease of 
communication with each other, and the IMS/360 log tape library. Manual 
logs of the user's choosing will aid in IMS/360 operation 
reconstruction. Current lists of data bases and application programs, 
the relationship of transaction codes to the application programs and 
their data bases, the physical terminal location and the lead remote 
terminal operator at that location, the type of terminal, telephone 
numbers, and the IBM Field Engineers* phone numbers are possible 
\ considerations for reference material. 

In this chapter considerable detail is supplied on each of the 
IMS/360 master terminal commands. Remote terminal command details are 
supplied in Chapter U . Instructions for their use are also contained in 
this chapter. There are three types of terminal input foimats: the 
normal message format, the message switching format, and the command 
message format. 

Messages and codes of IMS/360 are listed in Chapter 7 of this manual 
as they apply to the master terminal and the System/360 console. 

MASTER TERMINAL OPERATION 

This section describes items relating to the operation of the master 
terminal and should be used in conjunction with the IBM SRL Operator's 
Guide for the type of terminal being used. The master terminal is 
defined as the terminal that is the heart of the Information Management 
System, as it is the source of systems control and information messages. 
The master terminal may be either an IBM 1050 or 27U0 typewriter 
terminal. The master terminal language is discussed as if a 2740 is 
being used. The differences between the 27U0 and the 1050 are 
described. Although the master terminal may be located near the 
computer, it has a function that is different from that of the 
System/360 console. Use of the System/360 console as master terminal is 
permitted but not recommended. 

I References to physical terminals in the following discussions refer 
I to the relative physical terminal on the line; that is, the first 

N I physical terminal on any line is always physical terminal 1 (PTERMl); 

J I the second, physical terminal 2 (PTERM2); etc. 
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MASTER TERMINAL COMMAND LANGUAGE 

A master terminal command is acceptable from only the master 
terminal. Any master terminal command results in the issuance of 
completion or error messages to the originating and affected terminals. 
There are no terminal commands that cannot be entered from the master 
terminal. A terminal command is formatted as follows: 

/VERB (Password) KEYWORD Pi KEYWORD P2 , P3. COMMENTS 

The /VERB (such as /STOP) is the first element. (Command verbs may 
be abbreviated to their first three characters.) The carriage-return 
key on the keyboard may be depressed (in order to position the print 
element at the left margin) before entering the /VERB. A password may 
be required, depending upon the definition of the verb at IMS/360 
security maintenance time. If it is required,, the password should be 
entered next. The password is normally enclosed in parentheses: 
(Password) . However, when entry is being made from a 1050 terminal, it 
may not be desired to print the password. Therefore, as an alternative, 
the password may be enclosed between bypass and restore characters: 

^PASSWORD* 

No spaces or intervening characters may be entered between the /VERB 
and the left parenthesis or bypass character and/or between the right 
parenthesis or restore character and the first letter of the first 
keyword. One or more keywords may be required, depending upon the 
format of the particular verb statement. The keyword may be separated 
from its parameter (as designated by PI or P2 above) by a space,, a dash 
(-), or an equal sign (=). Unless otherwise noted, multiple parameters 
may be attached to a given keyword, as designated by P2, P3 above. 
Multiple parameters must be separated by a comma or a comma followed by 
a blank. A blank (no comma) must separate the last parameter for a 
given keyword from the next keyword, as designated by PI above. For 
purposes of documentation, comments or notes may be added at the end of 
a terminal command. However, in order to mark the end of the command, a 
period must be entered following the last parameter, if comments are to 
be added thereafter. 



MASTER TERMINAL COMMANDS 



CORRECTION OF MASTER TERMINAL COMMANDS 

The following are methods to be used in case an error has been made 
when entering a master terminal command: 

Backspacing - If the EOB or CR (carriage- return) key has not been 
depressed, a typing error may be corrected by depressing the 
backspace key to the incorrect character, retyping it correctly, 
and retyping all subsequent characters. 

Single line deletion - If it is necessary to delete a typed line, 
** must be typed before the EOB or CR key is depressed. 



MASTER TERMINAL COMMAND KEYWORD DEFINITIONS 

Since many commands utilize the same keywords and parameters, 
reference should be made to the following directory when reviewing the 
commands : 
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LINE 



is the keyword referring to a communication line; correct 
parameters are one- to three-character line numbers. 



PTERM 



is the keyword referring to a relative physical terminal; correct 
parameter is a number corresponding to the relative position of 
the terminal on the line. 



LTERM 



is the keyword referring to a logical terminal; correct 
parameters are one- to eight-alphameric-character logical 
terminal names. 



TRAN 



is the keyword referring to a transaction code; correct 
parameters are one- to eight- alphameric-character transaction 
codes. 



PROGRAM 



is the keyword referring to a program; correct parameters are 
one- to eight-alphcimeric-character program names. 



DATABASE 



is the keyword referring to a data base; correct parameters are 
one- to eight-alphameric-character data base names. 



ALL 



may be used as a parameter with many keywords. The specific 
acceptable uses of this parameter are duly noted in the 
descriptions of the individual commands. 



PI, P2, etc. 



are abbreviations used to designate possible parameters in the 
descriptions of the various verbs. 



MASTER TERMINAL KEYWORD SYNONYMS 

The following table relates the keywords used in the master terminal 
commands to their allowable synonyms. Where no synonym is listed, none 
is permitted. 
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Keyword 


Synonym 


ABDUMP 




ACTIVE 




ASSIGNMENT 




BLDQ 


BLDQS, BUILDQ, BUILDQS 


CHECKPOINT 


CHKPT, CHECKPT, CHKPOINT 


CPRI 




DATABASE 


DATABASES, DB, DBS 


DUMPQ 


DUMPQS 


FORMAT 


FMT 


FREEZE 




LINE 


LINES 


LMCT 


LCT 


LPRI 




LTERM 


LTERMS 


NPRI 




PASSWORD 


PASSWORDS, PSWD, PSWDS 


PRIORITY 


PRTY 


PLMCT 


PLOT 


PROGRAM 


PROGRAMS, PROG, PROGS, PGM, PGMS 


PTERM 


PTERMS 


PURGE 




QUEUE 


QUEUES, Q, QS 


REGION 


REGION, REG, REGS, MSGREG, MSGREGS,, 




MSGREGION, MSGREG IONS 


RESEND 




SER 


SERS, SERIAL, SERIALS 


STATUS 




STOP 




TAPE 


TAPES 


TERMINAL 


TERMINALS, TERM, TERMS, TER, TERS 


TRAN 


TRANS, TRANSACTION, TRANSACTIONS, TRANCODE, 




TRANCODES 
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MASTER TERMINAL NULL WORDS 

For purposes of clarity, at the user's discretion the following words 
are considered null words. They may be used within commands at any 
time. 

AFTER 

FOR 

SECURITY 

TO 

ON 

MODE 



TERMINAL COMMAND SYNTAX 



The syntax for all terminal command parameter descriptions is much 
like that of Operating System/360: 

1. Words written in all capital letters must appear exactly as 
written. 
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2. Wprds written in lowercase letters are to be replaced by a 
user-specified value. 

3. Enclosing a parameter in brackets indicates that it is optional. 
If more than one parameter is thus enclosed, either all must be 
present or all must be omitted. 

U. Enclosing a group of parameters in braces on several lines 
indicates that a choice is to be made of one of the lines of 
parameters. 

5. The symbols [ 1, { >» and ,... are used as an aid in defining 
the instructions. THESE SYMBOLS ARE NOT CODED; they act only to 
indicate how an instruction may be written. 

[ ] indicates optional operands. The operand enclosed in the 
brackets (for example, [VL] ) may be coded or not, depending 
on whether the associated option is desired. If more than 
one item is enclosed in brackets (for example, rREREADl ) , 
one or more may be coded. [leave J 

{ } indicates that a choice must be made. One of the operands 
from the vertical stack within braces (for example, 

(input ) ) must be coded, depending on which of the 

(output/ 
associated services is desired. 

,.. .indicates that more than one set of operands may be 
designated in the same instruction. 



COMPjyRISON OF START, STOP, PSTOP, AND PURGE COMMANDS 

The first group of commands, /START, /STOP, /PSTOP, and /PURGE, are 
all functionally related. Therefore, it should be noted that each of 
these commands completely overrides any previously issued related 
command. With the exception of /START, none of these commands is 
instantly effective. For example, if /STOP is issued relative to a 
given terminal that is receiving output, the report will be completed, 
rather than being stopped immediately. Thereafter, the response to the 
/STOP command will be printed on the stopped terminal,. The message that 
is a response to a terminal command will override the generated status 
of the line, terminal, etc. Although issued by the master terminal, the 
commands /STOP, /PSTOP, and /PURGE are not acceptable for the master 
terminal logical terminal, the master terminal physical terminal, or the 
line on which the master terminal is located. See Figure U for a 
comparison of this first group of commands. 
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TERMINAL/LINE | 


TRANS 1 


PROGRAM 


1 DB 


COMMAND 
















REG 


SEND 


Q 0/P| 


SCHED 


1 Q 1 


EXECUTE 


1 USE 


/START 


YES 


YES 


YES 1 


YES 


i 1 

|YES| 
1 1 


YES 


1 YES 


/STOP 


NO 


NO 


YES 1 


NO 


1 1 
|N0 1 
1 1 


NO 


1 NO 


/PSTOP 


NO 


NO 


YES 1 


NO 


1 1 
|YES| 
1 1 






/PURGE 


NO 


YES 


YES 1 


YES 


1 1 

|N0 1 

1 1 







L J 

REC allows receipt of input messages. 

SEND initiates sending of output messages. 

Q 0/P allows output message queuing from processing. 

SCHED allows scheduling of messages for processing. 

Q allows input queuing of messages. 

EXECUTE allows use of a program for processing. 

USE allows use of data base for processing. 



Figure 4. Comparison of /START, /STOP, /PSTOP, and /PURGE commands 

START AND STOP COMMANDS 

Since they are exact opposites, these two commands are discussed 
together. Entry of either of these commands would normally be 
restricted to the master terminal but could be allowed from any remote 
terminal. /STOP stops the sending, receiving, or queuing of output 
messages relative to a particular communications line or terminal, stops 
the scheduling or queuing of messages containing a specific transaction 
code, stops the execution of a specific program, and/or stops the use of 
a given data base. Note that /START and /UNLOCK commands or /STOP and 
/LOCK commands are not identical. The formats of /START and /STOP are 
identical.. The following /START and /STOP formats are acceptable: 



/START 

or 
/STOP 



[ (Password)] 



DATABASE] 
LINE 
LTERM 
PROGRAM 
ITRAN 



jPl,...Pni 

Iall ) 



[ (Password) 1 LINE PI PTERM 
(see Note) 



(Pl,...Pn) 
(ALL / 



t (Password)] REGION 



Note ; When used with PTERM, multiple parameters cannot be used with the 
LINE keyword. 
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EXAMPLES OF START AND STOP COMMANDS 



EXAMPLE 1: 



/START LINE 4,5,6,7,8,9,10,11 
MT: *START COMMAND COMPLETED 



• Entry MT 

• Response 

• Response RT: *TERMINAL STARTED 



Explanation ; /START with keyword LINE means 
start polling, send output, and queue output to 
those terminals on the above lines. MT means 
master terminal and RT means remote terminal. 



EXAMPLE 2: 



/START LINE 4 PTERM 1, 2 
MT: * START COMMAND COMPLETED 



• Entry MT 

• Response 

• Response RT: *TERMINAL STARTED 



EXAMPLE 3: 

• Entry MT 

• Response 

• Response 



Explanation : /START with keyword LINE and PTERM 
means start receiving input, start sending 
output, and start queuing output to relative 
physical terminals 1 and 2 on Line U. 



/START LTERM APPLE, TREE, FRUIT 

MT: * START COMMAND COMPLETED 

RT: *TERMINAL STARTED (*appropriate teanninal started) 

Explanation : /START with keyword LTERM means 
queue output messages and send messages to the 
specified logical terminals. 



EXAMPLE 4 



• Entry MT 

• Response 

• Response RT: NONE 



/START TRAN PIT, SEED 
MT: * START COMMAND COMPLETED 



EXAMPLE 5: 

• Entry MT: 

• Response 

• Response 



Explanation : /START with keyword TRAN means 
queue input messages and schedule this 
transaction code. Warning ; When /STOP and 
/PURGE are used with this keyword, queuing of 
input is stopped only if the message to be queued 
originates at a terminal. Output from an 
application program is always queued. 



/START DATABASE TREEFARM 
MT: *START COMMAND COMPLETED 
RT: NONE 
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• Entry MT: /START DATABASES ALL 

• Response MT: * START COMMAND COMPLETED 

• Response RT: NONE 



Explanation ; /START with keyword DATABASE means 
to allow scheduling of any program using this 
data base or all the data bases. 



EXAMPLE 6: 



• Entry MT: /START PROGRAM APPLETREEl 

• Response MT: * START COMMAND COMPLETED 

• Response RT: NONE 

• Entry MT: /START PROGRAM ALL 

• Response MT: *START COMMAND COMPLETED 

• Response RT: NONE 



Explanation ; /START with keyword PROGRAM means 
to allow scheduling of this program or, when used 
with ALL, to allow scheduling of all the 
programs . 



EXAMPLE 7; 



• Entry MT: /START REGION 

• Response MT: * START MSGREG COMMAND IN PROGRESS 

• Response MT: IMS116I MESSAGE PROCESSING REGION STARTED 

• Response RT: NONE 

Explanation : /START with keyword REGION means to 
use the facilities of Operating System/360 to 
start a message region (one) . This command and 
its keyword are cumulative in effect. To start 
two message regions, the command would be entered 
twice. The processing is also done on a net 
basis. If /START were entered once, the net 
result would be to start one message region. 

EXAMPLE 8: 

• Entry MT: /STOP LINE 4,5,6,7,8,9,10,11 

• Response MT: *STOP COMMAND COMPLETED 

• Response RT: *TERMINAL STOPPED 

Explanation : /STOP with keyword LINE means do 
not poll, do not send output, and do not queue 
output. /PURGE and /STOP Stop queuing of output 
only if the message to be queued originates at a 
terminal (message switching) . Output from an 
application program is always queued. MT means 
master terminal and RT means remote terminal. 
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EXAMPLE 9: 



I • Entry MT: /STOP LINE U PTERM 1, 2 



Response MT: *STOP COMMAND COMPLETED 



• Response RT: *TERMINAL STOPPED 



EXAMPLE 10 : 
o Entry MT: 

• Response 

• Response 



Explanation ; /STOP with keywords LINE and PTERM 
means do not receive input, do not send output, 
and do not queue output. 



/STOP LTERM APPLE, TREE, FRUIT 

MT: *STOP COMMAND COMPLETED 

RT: ♦TERMINAL STOPPED 

Explanation : /STOP with keyword LTERM means do 
not queue output messages, and do not send 
messages to this logical terminal. 



EXAMPLE 11: 



• Entry MT 

• Response 

• Response RT: NONE 



/STOP TRAN PIT, SEED 
MT: *STOP COMMAND COMPLETED 



Explanation : /STOP with keyword TRAN means do 
not queue input and do not schedule this (these) 
transaction code(s). /STOP and /PURGE with 
keyword TRAN mean stop queuing of input only if 
the message to be queued originates at a 
terminal. Output from an application program is 
always queued. 



EXAMPLE 12: 

• Entry MT 

• Response 

• Response 



EXAMPLE 13 ; 

• Entry MT 

• Response 

• Response 



/STOP DATABASE TREEFARM 
MT: *STOP COMMAND COMPLETED 
RT: NONE 



Explanation ; /STOP with keyword DATABASE means 
do not schedule a program using this data base. 



/STOP PROGRAM APPLETREEl 
MT: *STOP COMMAND COMPLETED 
RT: NONE 



Explanation : /STOP with keyword PROGRAM means do 
not schedule this program. 



23 



EXAMPLE lU; 



• Entry MT: /STOP REGION 



Response MT: 
Response MT: 
Response RT: NONE 



♦STOP COMMAND COMPLETED 

IMS117I MESSAGE PROCESSING REGION STOPPED 



Explanation : /STOP with keyword REGION means to 
use the facilities of Operating Systein/360 to 
terminate a message region (one) . This command 
is cumulative in effect. To stop two message 
regions, the command would be entered twice. The 
processing is also done on a net basis. If /STOP 
were entered once, the net result would be to 
stop one message region. 



PROCESS STOP COMMAND (PSTOP) 

This command (Process Stop) stops the sending and receiving of 
messages relative to a particular communications line or terminal, or 
stops the scheduling of messages containing specific transaction codes. 
This command allows the queuing of output messages relative to the 
specified communications line or terminal and/or allows the input and 
output queuing of messages containing the specified transaction codes. 

/PSTOP and /LOCK are functionally similar in that they both allow 
queuing. Entry of either of these commands would normally be restricted 
to the master terminal but could be allowed from any remote terminal. 
In addition, different bits are affected, so as to allow both 
operational and security control. The same formats are acceptable for 
/PSTOP as were described for the verbs /START and /STOP, except DATABASE 
or PROGRAM. (See format description under START and STOP Commands.) 



/PSTOP I ( LINE 

[ (Password) ] -j LTERM 

(tran 



HPl,... 
ALL 



Pn 



[(Password)] LINE PI PTERM 



(See Note) 



L 

Note: 



PI , . . . Pn , 



ALL 



J 



Multiple parameters cannot be used with the LINE keyword. 
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EXAMPLES OF PSTOP COMMAND 
EXAMPLE 1: 

• Entry MT: /PSTOP LINE U PTERM 1 

• Response MT: ♦PSTOP COMMAND COMPLETED 

• Response RT: *TERMINAL PSTOPPED 



Explanation ; /PSTOP with keyword LINE or key- 
words LINE and PTERM means do not receive input, 
do not send output, but queue output. MT means 
master terminal and RT means remote terminal. 



EXAMPLE 2: 



• Entry MT: /PSTOP LTERM APPLE, TREE 

• Response MT: ♦PSTOP COMMAND COMPLETED 

• Response RT: ♦TERMINAL PSTOPPED 



Explanation : /PSTOP with keyword LTERM means 
queue output messages and do not send messages to 
this logical terminal. 



EXAMPLE 3 



• Entry MT: /PSTOP TRAN SEED 

• Response MT: ♦PSTOP COMMAND COMPLETED 

• Response RT: NONE 



Explanation : /PSTOP with keyword TRAN means 
queue input and do not schedule this transaction 
code. 



PURGE COMMAND 



This command stops the receiving and input queuing of messages 
relative to a particular communications line or terminal, or stops the 
input and output queuing of messages containing the specified 
transaction code. This command allows the sending of messages relative 
to the specified communications line or terminal and/or allows the 
scheduling of messages containing the specified transaction code. See 
Figure 4 for a comparison of commands. Entry of this command would 
normally be restricted to the master terminal but could be allowed from 
any remote terminal. The following formats are acceptable for the 
/PURGE verb: 



/PURGE 



L 



[(Password)] (LINE )(Pl,...Pn) 
J TRAN j( ALL ) 
( LTERM) 

[(Password)] LINE PI PTERM ( Pl,...Pn 

(ALL 
(See Note) 

J 



Note: Multiple parameters cannot be used with the LINE keyword. 
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EXAMPLES OF PURGE COMMAND 
EXAMPLE 1: 

• Entry MT: /PURGE LINE H 

• Response MT: *PURGE COMMAND COMPLETED 

• Response RT: *TERMINAL PURGING 



Explanation : /PURGE with keyword LINE means do 
not poll, send output, and do not queue output. 
/PURGE and /STOP stop queuing of output only if 
the message to be queued originates at a terminal 
(message switching) . Output from an application 
program is always queued. MT means master 
terminal and RT means remote terminal. 



EXAMPLE 2: 



• Entry MT: /PURGE LINE ^ PTERM ALL 

• Response MT: *PURGE COMMAND COMPLETED 

• Response RT: *TERMINAL PURGING 



Explanation : /PURGE with keywords LINE and PTERM 
means do not receive input, send output, and do 
not queue output. 



EXAMPLE 3: 



• Entry MT: /PURGE LTERM APPLE, TREE, FRUIT 

• Response MT: *PURGE COMMAND COMPLETED 

• Response RT: *TERMINAL PURGING 



Explanation : /PURGE and keyword LTERM means do 
not queue output messages, and send messages to 
this logical terminal. 



EXAMPLE 4: 



• Entry MT: /PURGE TRAN PIT, SEED 

• Response MT: *PURGE COMMAND COMPLETED 

• Response RT: NONE 



Explanation : /PURGE with keyword TRAN means do 
not queue input, and schedule this transaction 
code. /STOP and /PURGE with keyword TRAN mean 
stop queuing of input only if the message to be 
queued originates at a teanninal. Output from an 
application program is always queued. 



CHANGE COMMAND 



This terminal command is used to change one password to another 
password. Password security is created by the IMS/360 security 
maintenance program and invoked at IMS/ 360 restart time through the 
presence of the PASSWORD operand. Entry of this command would normally 
be restricted to the master terminal but could be allowed from any 
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remote terminal. Once deleted, password or terminal security is not 
reestablished until either a cold start or a warm start with TERMINAL or 
PASSWORD parameters is performed. These formats are acceptable for this 
type of command: 



I /CHANGE j [(Password)] (PASSWORD PI TO P2 

I I (password pi to PASSWORD P2 ) | 

L J 



PASSWORD PI must be defined prior to the entry of this command at 
security maintenance time, as its execution results in a direct password 
replacement. If the password operand PI does not exist in the user's 
IMS/360 system, the /CHANGE command is rejected. When this command is 
entered, PASSWORD P2 must not have been previously defined, as duplicate 
passwords are not acceptable and will result in rejection of the 
command. 



EXAMPLE OF CHANGE COMMAND 

• Entry MT: /CHANGE PASSWORD 1234 to WXYZ 

• Response MT: *CHANGE COMMAND COMPLETED 

• Response RT: NONE 

Explanation ; This command is used to change one 
password to another. MT means master terminal 
and RT means remote terminal. 



ASSIGN COMMAND 

The /ASSIGN command is used to correlate the specified logical 
I terminal to relative physical terminals on communication lines for input 
and output. It can also be used to temporarily assign a current 
priority, a normal priority, a limit priority, a limit count, or a 
processing limit count to one or more transaction codes. (See Notes U 
and 5 . ) 

The /ASSIGN command is rejected if a LINE or PTERM operand relates to 
I a switched network. Unless the logical terminal to be reassigned is the 
j master terminal, it must be stopped prior to being reassigned. 
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/ASSIGN 



C (Password)] LTERM PI TO LINE P2 PTERM P3 
(See Note 1) 

((Password)] LTERM PI TO LINE P2 PTERM P3 PTERM PU 
(See Note 2) 

[(Password)] LTERM PI TO LINE P2 PTERM P3 LINE 
PU PTERM P5 
(See Note 3) 

[(Password)] CPRI PI TO TRAN P2,...Pn 

[(Password)] LPRI PI TO TRAN P2,...Pn 

[(Password)] NPRI PI TO TRAN P2,...Pn 

[(Password)] LMCT PI TO TRAN P2,...Pn 

[(Password)] PLMCT PI TO TRAN P2,...Pn 



Note 1: LTERM PI will be assigned to LINE P2 PTERM P3 for both input 
and output. 

Note 2: LTERM PI will be assigned to LINE P2 PTERM P3 for input and 
will be assigned to LINE P2 PTERM PU for output. 

Note 3: LTERM PI will be assigned to LINE P2 PTERM P3 for input and 
will be assigned to LINE P4 PTERM P5 for output. 

Note U: If the logical terminal to be assigned is the master 

terminal, the logical terminal and the line and relative 
physical terminal to which it is to be assigned must be in a 
start status. In addition, the line and relative physical 
terminal for input and output must be the same. 

If the logical terminal to be assigned is not the master 
terminal, the logical terminal must be in a stop status prior 
to the entry of this command. 



Note 5: 



where : 



CPRI 



LPRI 



NPRI 



is the keyword referring to the current priority of a transaction 
code; correct parameters are one- or two-character numeric 
priorities, from to 11, inclusive. 



is the Iceyword referring to the limit priority of a transaction 
code; correct parameters are one- to two-character numeric 
priorities, from to lU, inclusive. 



is the keyword referring to the normal priority of a transaction 
code; correct parameters are one- or two-character numeric 
priorities, from to 14 inclusive. 



( 
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LMCT 



PLMCT 



is the keyword referring to the limit count of a transaction 
code; correct parameters are numeric values ranging from to 
65,535. 



is the keyword referring to the processing limit count of a 
transaction code; that is, the maximum number of messages 
enqueued on this SMB that will be allowed to be in process during 
any single program load. Correct parameters are numeric values 
ranging from 1 to 65,535. 



EXAMPLES OF ASSIGN COMMAND 
EXAMPLE 1: 

I • Entry MT: /ASSIGN LTERM APPLE TO LINE 5 PTERM 1 

• Response MT: *ASSIGN COMMAND COMPLETED 

• Respons e RT : NONE 



Explanation : /ASSIGN with keywords LTERM, LINE, 
and PTERM correlates a specified logical terminal 
with a specific relative physical terminal. MT 
means master terminal and RT means remote 
terminal. 



EXAMPLE 2 



• Entry MT: /ASSIGN CPRI 8 TO TRAN PIT, SEED 

• Response MT: *ASSIGN COMMAND COMPLETED 

• Response RT: NONE 



Explanation : /ASSIGN with keyword CPRI and TRAN 
means to temporarily assign a current priority 
level to one or more specific transaction codes. 



DELETE COMMAND 

The DELETE command is used to eliminate password security for a given 
transaction code, logical terminal, relative physical terminal, data 
base, or program. Entry of this command would normally be restricted to 
the master terminal but could be allowed from any remote terminal. It 
may also be used to eliminate terminal security for a given transaction 
code. Logical terminals, physical terminals, data bases, and programs 
cannot be secured by terminal security. Once deleted, password or 
terminal security is not reestablished until either a cold start or a 
warm start with TERMINAL or PASSWORD parameters is performed. 
Acceptable formats of this command are: 
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/DELETE I [ (Password) ] PASSWORD SECURITY FOR 

DATABASE' 
LTERM 

PROGRAM ( Pl,...Pn 
TRAN 

[(Password)] PASSWORD SECURITY FOR LINE Pi PTERM 
PI, ...Pn 
(see Note) 

[(Password)] TERMINAL SECURITY FOR TRAN Pl,...Pn 

Note: Multiple parameters cannot be used with the LINE keyword. 

where : 

PASSWORD 

is the keyword referring to password security; correct parameters 
are of length n or less, as designated in the security 
maintenance program. 



TERMINAL 



is the keyword referring to terminal security; correct parameters 
are of length n or less, as designated in the security 
maintenance program. 



EXAMPLES OF DELETE COMMAND 
EXAMPLE 1: 

/DEL PSWD FOR DATABASE TREEFARM 
♦DELETE COMMAND COMPLETED 
NONE 



• Entry MT: 

• Response MT: 

• Response RT: 



Explanation : /DELETE with keyword PASSWORD 
eliminates password security for one or more 
transaction codes, relative physical terminals, 
logical terminals, programs, or data bases. MT 
means master terminal and RT means remote 
terminal . 



EXAMPLE 2: 



• Entry MT: /DEL TERM SECURITY FOR TRAN PIT, SEED 

• Response MT: *DELETE COMMAND COMPLETED 

• Response RT: NONE 



Explanation : /DELETE with keyword TERMINAL 
eliminates terminal security for one or more 
transaction codes. 
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DISPLAY COMMAND 

Entry of the DISPLAY command would normally be restricted to the 
master terminal but could be allowed from any remote terminal, depending 
on what commands the particular system allows and has had defined at 
security maintenance time. The command provides the ability to display 
critical fields of specific IMS/360 control blocks and certain system 
queues. The purpose of these displays is to enable the master terminal 
operator to gain an insight into his dynamically changing system so that 
he can more effectively control operation of his IMS/360 system through 
the use of other command language verbs. 



/DISPLAY 
[ (Password) ] 



: STATUS I 
MASTER [ 

'active) 



QUEUE 


PRIORITY (Priority [ , . . . .priority n] " 
(ALL 


THAN 


code [,.... code n] 
ALL 




PROGRAM 


name [,.... name n] 
ALL 


DATABASE 


name [,.... name n] 
ALL 


(number [,.... number n] 
LINE 

ALL 




number [,.... number n] 
LINE number PTERM 

ALL 


name [,..... name n] 
LTERM 

ALL 



ASSIGNMENT LTERM 



name [,.... name n] 
ALL 



ASSIGNMENT LINE number 

number [,.... number] 



PTERM 



ALL 



L . J 

where: 

STATUS displays all the: 

• Transaction codes (TRAN) for which input is not to be queued, 
for which the transaction code is not to be scheduled,, for 
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MASTER 



ACTIVE 



QUEUE 



Which the transaction code is locked, or for which the 
transaction code is locked specifically for DBDUMP. 

Data bases that are not to be used or that are locked. 
Programs that are not to be executed or that are locked. 
Lines where no input and/or output activity is allowed, where 
no queuing is allowed, or where the line is idle. 
Relative physical terminals (PTERM) where no input and/or 
output activity is allowed, where no queuing is allowed, where 
the Communication Terminal Block (CTB) is locked, or where the 
relative physical terminal is inoperable. 

Logical terminals (LTERM) where no output activity is allowed, 
where no queuing is allowed, or where the logical terminal is 
locked. 



displays the logical terminal name, the relative physical 
terminal address, and the line number assigned as the master 
terminal. 



displays which transaction code for which program is active in 
the Type 1 processing (message) region (s) and Type 2 processing 
(batch) region at that particular instant. 



displays the message queue according to priority, transaction type, 
and message count. Messages enqueued upon transactions which have 
been scheduled for processing by a message processing program are 
not included in the queue counts as a result of the /DISPLAY QUEUE 
command. This verb can be further broken down by adding another 
keyword, PRIORITY n, followed by the priority numbers or ALL, to 
display those transaction types by name. 



TRAN code. 



displays the specific data for the transaction code(s) following 
the verb TRAN. 



PROGRAM name,, .... 



displays the specific data for the program name(s) following the 
verb PROGRAM. 



DATABASE name, .... 



displays the specific data for the data base name(s) following 
the verb DATABASE. 



LINE number, .... 



displays the specific data for each numbered communication 
line(s) following the verb LINE. 

This LINE verb has a further breakdown. Example: 

/DISPLAY LINE 3 PTERM ALL 

This means display all data concerning line 3 by relative 
physical terminal. 
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LTERM name, .... 

displays specific data concerning the logical terminal name(s). 

ASSIGNMENT LTERM name, .... 

displays what input and output communication line and relative 
physical terminal are assigned to each LTERM. 

The ASSIGNMENT keyword can have LINE number with PTERM 
following- Example: 

/DISPLAY ASSIGNMENT LINE 2 PTERM ALL 

This means that for line 2 and the relative physical terminal 
a display will list the logical terminal name assigned at 
present. 



EXAMPLES OF DISPLAY COMMAND 

the following examples use abbreviations which are 



The responses in 
defined below. 

Abbreviation 

ADDR 

B-II 

CP 

DIAL 

DIAL CTB 

ERRCT 

INV COUNT 
LCT 
Line 1 
LIN/PTE 

LOG 

LP 

MT 

NP 

OUTPUT DEQCT 

OUTPUT ENQCT 

OUTPUT OCT 



Definition 

Unit address in IMS/360 system definition 

Batch region 2 

Current priority 

Indicates pool CTB 

Telephone number instead of terminal 
address 

Error count (number of transmission line 
errors) 

Invocation count 

Limit count 

Indicates computer console 

Line and relative physical terminal address 
(a number corresponding to the relative 
position of the terminal on the line) 

Updates log for this data base 

Limit priority 

Master terminal 

Normal priority 

Number of messages sent on this line 

Number of messages enqueued for output on 
this line 

Number ^of messages remaining to be sent 
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PEM Partially entered messages 

PLCT Processing limit count 

QCT Queue count 

RECD Number of messages received on this line 

RT Remote terminal 

TP Teleprocessing 

Note ; Exception status is also listed, on the far right side of the 
message. 

EXAMPLE 1: 

• Entry MT: /display status 

• Response MT: 

♦*TRAN** 



DFSIBDRS 


PSTOPPED 


DLI 


PSTOPPED 


DLN 


PSTOPPED 


ICS 


PSTOPPED 


NOP 


PSTOPPED 


SWI 


PSTOPPED 


SWIBR 


PSTOPPED 


♦♦DATABASE** 


DFSIBDRT 


STOPPED, lOCKED , NOTOPEN 


DI31IPH01 


NOTOPEN 


DI31IPH02 


NOTOPEN 


♦* PROGRAM** 




HIMASNOl 


STOPPED 


SWITCH 


STOPPED 


**LINE** 




U 


STOPPED, IDLE 


5 


STOPPED, IDLE 


6 


STOPPED, IDLE 


7 


STOPPED, IDLE 


8 


STOPPED, IDLE 


9 


STOPPED, IDLE 


10 


STOPPED, IDLE 


11 


STOPPED, IDLE 


12 


STOPPED, IDLE 


13 


STOPPED, IDLE 


m 


STOPPED, IDLE, NOTOPEN 


**PTERM** 




2-1 


PURGING 


U-1 


COMPINOP 


**LTERM** 




L27U0SM1 


STOPPED 


L27U0S1 


STOPPED 



( 



*68295/12283tt 
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EXAMPLE 2: 

• Entry MT: /display master 

• Response MT: 

LTERM MASTER 
PTERM 3-1 

♦68295/130245* 

EXAMPLE 3: 

• Entry MT: /display active 

• Response MT: 



JOBNAME 


TYPE 


TRAN/STEP 


PROGRAM 


MESSAGE 


TP 


WAITING 




BATCHREG 


B-11 


NONE 




ACTIVE- IN - 


1 






ACTIV-OUT - 


1 







♦ 68295/1211909* 

EXAMPLE 4: 

• Entry MT: /display queue 

• Response MT: 



NUMBER OF MESSAGE 
PRTY TRAN CODES COUNT 



NO QUEUES 
♦68276/12472U* 

• Entry MT: /display queue 

• Response MT: 

NUMBER OF MESSAGE 
PRTY TRAN CODES COUNT 



8 


1 


U 


5 


3 


6 


1 


2 


U 


TOTAL 


6 


lU 


♦68295/123016* 
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• Entry MT: /display queue priority 0,1,5,8,12,16 

• Response MT: 



PRTY 


TRAN 


MESSAGE 
COUNT 





NO QUEUES 




1 
1 

TOTAL 


NOP 
SWI 


1 
3 


5 
5 
5 
TOTAL 


DLI 
ICS 
SWIBR 


2 
3 
1 
6 


8 
TOTAL 


DLN 




12 


NO QUEUES 





16 IS INVALID 
TOTAL MSG COUNT 
♦68295/123106* 



m 
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• Entry MT: /display queues priority all 

• Response MT: 



PRTY 


THAN 


MESSAGE 
COUNT 





NO 


QUEUES 




15 


NO 


QUEUES 




m 


NO 


QUEUES 




13 


NO 


QUEUES 




12 


NO 


QUEUES 




11 


NO 


QUEUES 




10 


NO 


QUEUES 




9 


NO 


QUEUES 




8 
TOTAL 


DLN 




7 


NO 


QUEUES 




6 


NO 


QUEUES 




5 
5 
5 

TOTAL 


DLI 
ICS 
SWIBR 


2 
3 

1 
6 


^ 


NO 


QUEUES 




3 


NO 


QUEUES 




2 


NO 


QUEXJES 




1 

1 
TOTAL 


NOP 
SWI 


1 
3 

4 



TOTAL MSG COUNT 
♦68295/123204* 
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EXAMPLE 5: 

• Entry MT: /display tran ims, swi, din, ics, dli 

• Response MT: 



TRAN 


PEM 


qcT 


LCT 


PLCT 


CP 


NP 


LP 




IMS 








10 


61223 


2 


2 


5 


P STOPPED 


SWI 








1000 


61223 


1 


1 


7 


PSTOPPED 


DLN 








3 


61223 








8 


PSTOPPED 


ICS 








5 


10 


5 


5 


12 




DLI 








5 


10 


5 


5 


10 





♦69155/132753* 
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• Entry MT: /display tran all 

• Response MT: 



TRAN 



PEM QCT LCT PLCT CP NP LP 



# 








6 


65535 


10 


10 


14 


ADDI 








5 


65535 


7 


7 


9 


ADDINV 








5 


65535 


7 


7 


9 


ADDPART 








5 


65535 


7 


7 


9 


ADDPN 








5 


65535 


7 


7 


9 


CLOSE 








65535 


65535 


1 


1 


1 


CLSORD 








5 


65535 


7 


7 


9 


DFSIBDRS 








65535 


65535 








15 


DISB 








2 


65535 


9 


9 


10 


DISBURSE 








65535 


65535 


1 


1 


1 


DLETI 








2 


65535 


5 


5 


7 


DLETINV 








2 


65535 


5 


5 


7 


DLETPART 








2 


65535 


5 


5 


7 


DLETPN 








2 


65535 


5 


5 


7 


DLI 








5 


10 


5 


5 


10 


DLN 








3 


61223 








8 


DSPALLI 








65535 


65535 


1 


1 


1 


DSPINV 








65535 


65535 


1 


1 


1 


DSPPN 








65535 


65535 


1 


1 


1 


ENQ 








65535 


65535 


8 


8 


8 


ICS 








5 


10 


5 


5 


12 


IMS 








10 


61223 


2 


2 


5 


INVTORY 








65535 


65535 


1 


1 


1 


NOP 








1 


5 


1 


1 


1 


PART 








65535 


65535 


1 


1 


1 


RJE 








10 


65535 


2 


2 


4 


SKHl 








65535 


65535 


8 


8 


8 


SKIl 








65535 


65535 


8 


8 


8 


SKI 2 








65535 


65535 


8 


8 


8 


SWI 








1000 


61223 


1 


■ 1 


7 


SWIBR 








4 


20 


5 


5 


5 


SWIPASS 








1 


20 


4 


4 


6 


SWI PR 








100 


20 


14 


14 


14 


SWITS 








1 


20 


4 


4 


6 


SWN 








H 


5 








4 


SWI 








65535 


65535 











SW2 








1000 


65535 











TPPLl 








65535 


65535 


8 


8 


8 


TPPL2 








65535 


65535 


8 


8 


8 


TUBE 








65535 


65535 


8 


8 


8 



69155/132309* 



EXAMPLE 6; 



• Entry MT: /display program himasnOl, switch 



• Response MT: 



PSTOPPED 



PSTOPPED 



/ 



PSTOPPED 



PROGRAM 

HIMASNOl 
SWITCH 



TYPE 

TP STOPPED 
TP STOPPED 



♦68295/124649* 
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• Entry MT: /display program all 

• Response MT: 



PROGRAM 

DFSIDBRO 
HIMASNOl 
NOPSB 
SWITCH 



TYPE 

TP 

TP STOPPED 

TP 

TP STOPPED 



♦68295/12U740* 

EXAMPLE 7: 

• Entry MT: /display database di21sn01, di31ph01 
o Response MT: 



DATABASE 

DI21SN01 
DI31PH01 



INV 
COUNT 






LOG 

YES STOPPED, LOCKED, NOTOPEN 
NO NOTOPEN 



♦68276/130115* 

Entry MT: /display database all 
Response MT: 





INV 










DATABASE 


COUNT 


LOG 








DFSIBDRT 





NO 


STOPPED, 


LOCKED, 


NOTOPEN 


DI21SN01 





NO 


STOPPED, 


LOCKED, 


NOTOPEN 


DI21SN02 





NO 


STOPPED, 


LOCKED, 


NOTOPEN 


DI22SN01 





NO 


STOPPED, 


LOCKED, 


NOTOPEN 


DI22SN02 





NO 


STOPPED, 


LOCKED, 


NOTOPEN 


DI31PH01 





NO 


NOTOPEN 






DI31PH02 





NO 


NOTOPEN 






DI31SK01 





NO 


NOTOPEN 






DS21SN01 





NO 


STOPPED, 


LOCKED, 


NOTOPEN 


DS21SN02 





NO 


STOPPED, 


LOCKED, 


NOTOPEN 


DS21RB02 





NO 


STOPPED, 


LOCKED, 


NOTOPEN 


ZZZZZZZZ 





NO 


STOPPED, 


LOCKED, 


NOTOPEN 



♦68276/126913* 
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EXAMPLE S: 

• Entry MT: /display line 1, 3, 5, 12 

• Response MT: 



LINE 

1 

3 

5 

12 



OUTPUT OUTPUT OUTPUT 
TYPE RECD ENQCT DEQCT QCT 



SYSTEM CONSOLE 

2740 18 12 

27U0 7 

1050 DIAL 1 



12 

1 



ERECT 



DIAL STOPPED, 
IDLE 



♦68295/125116* 

• Entry MT: /display line all 

• Response MT: 









OUTPUT 


OUTPUT 


OUTPUT 






LINE 


TYPE 


RECD 


ENQCT 


DEOCT 


QCT 


ERRCT 


1 


SYSTEM 


CONSOLE 












2 


2740 


6 


6 


6 










3 


2740 


21 


14 


14 










H 


2740 





2 





2 


0' 


STOPPED, IDLE 


5 


2740 


4 


12 


4 










5 


2740 


12 


4 


4 










6 


2740 

















STOPPED, IDLE 


7 


2740 

















STOPPED, IDLE 


8 


1050 

















STOPPED, IDLE 


9 


1050 

















STOPPED, IDLE 


10 


1050 

















STOPPED, IDLE 


11 


1050 


DIAL 











DIAL 


STOPPED, IDLE 


12 


1050 


DIAL 


1 


1 





DIAL 


STOPPED, IDLE 


13 


1050 


DIAL 











DIAL 


STOPPED, IDLE 


14 



















STOPPED , IDLE , NOTOPEN 



/^ 



♦68295/125326* 
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EXAMPLE 9: 

• Entry MT: /display line U pterm all 

• Response MT: 



LIN/PTE 

4-1 
4-2 



TYPE 

2740 
2740 



OUTPUT OUTPUT OUTPUT 
ADDR RECD ENQCT DEQCT QCT ERRCT 



032 
032 



2 PURGING, COMPINOP 




♦68295/125912* 



• Entry MT: /display line 12 pterm all 



• Response MT: 



OUTPUT OUTPUT OUTPUT 
LIN/PTE TYPE ADDR RECD ENQCT DEQCT QCT ERRCT 



12-1 



1050 038 DIAL 



1 



DIAL 



♦68295/125745* 

• Entry MT: /display pterin 1, 2 on line 4 

• Response MT: 



LIN/PTE 

4-1 
4-2 



TYPE 

2740 
2740 



ADDR 

032 
032 



OUTPUT OUTPUT OUTPUT 
RECD ENQCT DEQCT QCT ERRCT 



2 PURGING, COMPINOP 




*68295/125514* 



EXAMPLE 10: 



• Entry MT: 

/display Iterm dialql,inquiryl,12740sl,12740sinl, master, wtor 

• Response MT: 



LTERM 



OUTPUT OUTPUT OUTPUT 
ENQCT DEQCT QCT 



DIALQl 













INQUIRYl 













L2740S1 


1 


1 





STOPPED 


L2740SM1 


1 





1 


STOPPED 


MASTER 


12 


12 







WTOR 














*68295/123755* 
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• Entry MT: /display Iterm all 



Response MT: 










OUTPUT 


OUTPUT 


OUTPUT 


LTERM 


ENQCT 


DEOCT 


QCT 


♦AUDIOl 











♦AUDI02 











♦AUDIO 3 











♦DSPLYl 











♦DSPLY2 











♦DSPLY3 











♦MASTER 


8 


8 





♦WTOR 











♦1050AA1 











♦1050AA2 











♦1050AA3 











♦2740AA1 











♦2740AA2 











♦27U0AA3 











♦27aoci 











♦27aOC2 











♦2740SM1 


2 


2 


STOPPED 


♦2740SM2 


2 


2 


STOPPED 


♦27U0S1 


1 


1 





♦27U0S2 


1 


1 






♦68276/125448+ 



r 



U2 



EXAMPLE 11 ; 

• Entry MT: 

/display assignment Iterm dialql,inquiryl,12740sl,127U0sinl, master, wtor 

• Response MT: 





INPUT 


OUTPUT 


LTERM 


LIN/PTE 


LIN/PTE 


1 DIALQl 


11-1 


11-1 


1 INQUIRYl 


5-1 


5-1 


1 L27aOSl 


3-1 


3-1 


1 L27U0SM1 


4-1 


U-1 


1 MASTER 


3-1 


3-1 


WTOR 


1-SC 


1-SC 



♦68295/130657* 

Entry MT: /display assignment Iterm all 
Response MT: 





INPUT 


OUTPUT 


LTERM 


LIN/PTE 


LIN/PTE 


1 CARDPUNCH 


lU-1 


ia-1 


1 DIALQl 


11-1 


11-1 


1 DIALQ2 


12-1 


12-1 


1 DIALQ3 


13-1 


13-1 


1 INQUIRYl 


5-1 


5-1 


1 INQUIRY2 


6-1 


6-1 


1 INQUIRY3 


7-1 


7-1 


1 INQUIRYU 


8-1 


8-1 


1 INQUIRY5 


9-1 


9-1 


j INQUIRY6 


10-1 


10-1 


1 L2740SM1 


U-1 


U-1 


1 L27aOSM2 


U-2 


4-2 


1 L2740S1 


3-1 


3-1 


1 L2740S2 


2-1 


2-1 


j MASTER 


3-1 


3-1 


1 NS1050 


m-1 


m-i 


1 PTPPUNCH 


lU-l 


14-1 


WTOR 


1-SC 


1-SC 



♦68295/160953* 



EXAMPLE 12: 

• Entry MT: /display assignment line 2 pterm all 

• Response MT: 

LIN/PTE 

2-1 IN - L2740S2 

OUT - L27U0S1, L27U0S2 

*68295/130910* 
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• Entry MT: /display assignment line 12 pterin all 

• Response MT: 

LIN/PTE 

12- 1 IN - INQUIRYl 
OUT - INQUIRYl 

♦68295/130005* 

• Entry MT: /display assignment line 3 pterm all 

• Response MT: 

LIN/PTE 

3-1 IN - MASTER, L27ttOSl 
OUT - MASTER 

♦68295/130848* 

• Entry MT: /display assignment line ^ pterm 1, 2 

• Response MT: 

LIN/PTE 

a-1 IN - L2740SM1 

OUT - L2740SM1 
a-2 IN - L2740SM2 

OUT - L2740SM2 

*68295/130328* 

CHECKPOINT COMMANDS 

The checkpoint facilities of the IMS/360 control program provide the 
means for periodically recording control information and status to 
enable IMS/360 restart after failure. This failure may be the 
termination of the IMS/360 control program or the loss of Operating 
System/360. In addition, the checkpoint facilities are the means for 
orderly termination of the IMS/360 system, creating a tape image 
(backup) of a data base used for message processing, or assisting in the 
reconstruction of a data base that has been destroyed. There are four 
checkpoint commands and two data base dump commands. Entry of these 
commands would normally be restricted to the master terminal but could 
be allowed from any remote terminal. 



Hf\ 



/CHECKPOINT 
[ (Password) ] 



blank 

FREEZE [ABDUMP] 

DUMPQ [ABDUMP] 

PURGE [ABDUMP] 



where: 



blank 



FREEZE 



means simple checkpoint, /CHECKPOINT with no operands. It may be 
invoked automatically by the IMS/360 control program or from the 
master terminal. The automatic invocation of simple checkpoint 
is based upon the number of entries to the system log. The user 
of IMS/360 may specify the number of entries between 
system- invoked checkpoints during the system definition* The 
simple checkpoint, like all other checkpoint commands, uses the 
IMS/360 system log for recording control data. The simple 
checkpoint logs the status of all dynamically changeable IMS/360 
control blocks- These include the logical to physical terminal 
relationships, the input and output message queue control blocks, 
the security blocks, and others,. The simple checkpoint command 
causes the scheduling of programs into message processing regions 
to halt momentarily while IMS/360 control block information is 
logged. The simple checkpoint command has no effect upon 
internal operations in the IMS/360 control program or operations 
upon the communication lines. As soon as the simple checkpoint 
command is terminated, scheduling into message regions is 
automatically initiated by the IMS/360 control program. 



is a checkpoint FREEZE command. The command /CHECKPOINT FREEZE 
is the fastest means for orderly termination of the IMS/360 
system. This command is invoked from the master terminal. Input 
communication lines are stopped as soon as any messages being 
entered are completely received. Output communication lines are 
stopped as soon as any messages in the process of being sent are 
completely transmitted. Message regions are terminated as soon 
as the current messages being processed have been completed. All 
input messages remaining to be processed and all output messages 
remaining to be transmitted are retained in the message queue 
data sets. The same mechanics as in simple checkpoint are then 
invoked to log all control block status. Finally, the checkpoint 
facility causes the termination of the IMS/360 control program 
job. The IMS/360 user should employ the /NRESTART command 
without message queue reconstruction to restart IMS/360 after a 
/CHECKPOINT FREEZE. This command should be entered only from the 
master terminal. 



DUMPQ 



The /CHECKPOINT DUMPQ command operates in exactly the same manner 
as the /CHECKPOINT FREEZE command, but performs the additional 
function of dumping all of the input and output messages from the 
message queue data sets to the IMS/360 system log tape. The 
/NRESTART command with message queue reconstruction should be 
employed to restart IMS/360 after a /CHECKPOINT DUMPQ 
termination. The restart of IMS/360 in this manner causes 
allocation of space in the queue data sets to start from the 
beginning of the data sets. The messages dumped from the queue 
data sets during the /CHECKPOINT DUMPQ command are reloaded into 
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PURGE 



the message queue data sets during the /NRESTART 
with-message-queue-reconstruction BLDQ coinmand. 



The /CHECKPOINT PURGE command is the most orderly yet most 
time-consuming manner of terminating IMS/360. The input 
communication lines are stopped first, as soon as all messages 
being entered are completely received. All messages in the input 
queue are processed, and all resultant output messages are 
transmitted to their specified destinations. The message regions 
are then terminated, and output communication lines are stopped. 
Finally, any input messages which could not be processed or any 
output messages which could not be transmitted are dumped to the 
IMS/360 system log, and the IMS/360 control program job is 
terminated. The /NRESTART command with message queue 
reconstruction (BLDQ) should be employed to restart IMS/360 after 
termination with a /CHECKPOINT PURGE command. 



The inclusion of the operand with FREEZE, DUMPQ, or PURGE will 
provide a SYSUDUMP of the IMS/360 Type region. 



EXAMPLES OF CHECKPOINT COMMANDS 

See Chapter 5 for uses of checkpoint commands. 
/ 
DATA BASE DUMP COMMANDS 



ABDUMP 



1 /DBDUMP 

I 

I [ (Password) ] 

I 

L 




DBDUMP DATABASE dname 

is the /DBDUMP command with DATABASE operand. DATABASE dname 
means the actual name of the data base being dumped. The command 
is entered from the master terminal and creates a dump tape 
image. This is accomplished by stopping all input of 
transactions (from terminals) that would update the data base and 
by processing all transactions already in the input queue against 
the data base. A special utility (a message processing program) 
is then scheduled for execution. This message processing program 
retrieves all segments from the data base with GET calls and 
creates a copy in the form of an HSAM tape data base with ISRT 
calls. When the data base dump is complete, the tape volume 
containing the copy is unloaded. Finally, the update 
transactions which had been stopped are again allowed entry from 
terminals. This command causes a force-end-of -volume on the 
IMS/360 log so that a new log is started immediately after the 
data base dump. The use of this command performs preparation 
functions for reconstruction of a data base. The format of the 
tape to which a data base is dumped is determined by the DD card 
contents with the ddname DBDUMP in the IMS/360 Type region JCL. 
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DBDUMP DATABASE dname STOP 

is the /DBDUMP coiranand with operand STOP. DATABASE dname means 
the actual name of the data base being diimped. The command is 
used in preparatory procedures prior to data base reconstruction. 
The /DBDUMP with STOP command causes all transactions (against a 
data base that must be reconstructed) to be retained in the input 
message queue and forces end-of- volume on the current log tape. 
The transactions left in the input queue are not scheduled for 
processing. The continuation of input of these transaction types 
is allowed, but no processing occurs. The data base must be 
reconstructed with a user-supplied batch program executed from an 
IMS/360 Type 3 region and a previously dumped copy of the data 
base. Once the data base is reconstructed with the last dump 
tape, all transactions from the data base dump until the current 
point in time must be reprocessed. This is accomplished with the 
old system log tapes and the data base recovery command. 

The /BROADCAST command (defined later) may be helpful in coordinating 
checkpoint and restart with remote terminal operators. 



EXAMPLES OF DBDUMP COMMANDS 

See Chapter 5 for uses of DBDUMP commands. 

RESTART COMMANDS 

The restart facilities of the IMS/360 system provide for recovery 
after a failure of IMS/360, its message queues, and the data bases used 
for message processing. Depending upon the type of failure,, the result 
may involve the loss of core storage contents or the loss of both core 
storage contents and contents of the message queue data sets. The 
restart facilities are designed to provide recovery from these described 
failures. 

In addition, the data base recovery capabilities of IMS/360 restart 
assist the IMS/360 user in reconstruction of data bases used for message 
processing. Reconstruction is necessary if the application programs 
have destroyed the meaningful content of a data base or if an 
input/output error occurs. 

Two types of restart command exist, normal and emergency restart. 
The normal restart command is used after the IMS/360 system has been 
terminated in a normal manner (for example, with a /CHECKPOINT command). 
The emergency restart command is employed when the IMS/360 system was 
not terminated normally. 
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Normal Restart 



/NRESTART 



CHKPT [FORMAT ALL] [TERMINAL] [PASSWORD] 



CHKPT number 



[ (Password)] 

^iBLDQ 

JbLDQ FORMAT ALL 

[SER number , number ] 
1 2 
[TERMINAL] [PASSWORD] 

L J 



where : 



CHKPT 



is a form of normal restart called a 
previous system log tape. 



"cold start" and involves no 



CHKPT number 



is the other form of normal restart, a "warm start". The system 
is restarted with the checkpoint data on a previous (normally the 
last used) system log tape. The checkpoint number specifies 
Julian date and time of day (yyddd/hhmmss) . This would have been 
recorded on the master terminal when a checkpoint was executed. 
The warm start version of the /NRESTART command without BLDQ 
assumes that the IMS/360 system had been terminated with a 
/CHECKPOINT FREEZE command. All messages are retained in the 
message queue data sets. When the /NRESTART command (with warm 
start) is executed, the data on the old system log tape provides 
the IMS/360 system with correct positioning within the data set. 



FORMAT ALL 



causes all message queue data sets to be formatted. The 
formatting of the message queue data sets need be done only at 
initial system start (first-time use of system) , when a message 
queue data set input/output error occurs, or when the size of the 
message queue data sets is to be changed. For a warm start, if 
FORMAT ALL is present, BLDQ must also be. 



BLDQ 



is an additional operand. Build Queue, which may be specified 
with the warm start version of the noinmal restart command. The 
BLDQ operand should be specified if the system was terminated 
with a /CHECKPOINT PURGE or /CHECKPOINT DUMPQ command. The BLDQ 
operand assumes that any messages remaining in the message queue 
data sets when the /CHECKPOINT PURGE or DUMPQ terminated were 
logged to the system log tape. The BLDQ operand causes the 
normal restart command to use the old log tape specified in the 
CHKPT operand and reloads any retained messages from the log to 
the message queue data sets. 

See Chapter 5 for additional information on performing a warm start. 
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TERMINAL 



is an optional operand. If TERMINAL is specified, the latest 
terminal security specifications from the user's IMS.RESLIB 
library (generated by the IMS/360 Security Maintenance Program) 
will be operational at completion of this normal restart. 



PASSWORD 



is an optional operand. If PASSWORD is specified, the latest 
password security specifications from the user's IMS.RESLIB 
library (generated by the IMS/360 Security Maintenance Program) 
will be operational at completion of this normal restart. 



SER 



means that the six-character serial number of the tape on which 
the checkpoint number resides may be specified. No more than two 
serial numbers may be specified. Normally, one tape serial 
number is used. The ability to enter two serial numbers 
considers the situation in which the checkpoint information spans 
two volumes. This operand is optional because the information 
may be entered through a dd card for the old log tape if 
procedures are not used for IMS/360. 

Examples of NRE START Command 

See Chapter 5 for uses of normal restart commands. 

Emergency Restart 

The emergency restart command is used to restart IMS/360 after a 
failure that caused' the IMS/360 nucleus or Operating System/360 to 
terminate abnormally. The emergency restart command always employs the 
last IMS/360 log tape to reinitiate system operation if only the 
contents of core storage are lost. The simplest version of the 
emergency restart command is used when a failure occurs that involves 
only the loss of the contents of core storage. The formats for 
emergency restart are: 



r ^ n 



/ERESTART 
[ (Password) ] 



CHKPT BLDQ FORMAT ALL [TERMINAL] [PASSWORD] 

[ SER niimber , . . . number ] 
1 n 



CHKPT number [BLDQ FORMAT ALL] 

[ SER number , . . . number ] 
1 n 

L J 

where: 
CHKPT 

is an emergency restart from a previous cold start. 
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CHKPT number 



is the checkpoint number from which the restart is to be 
processed. This would have been recorded on the master terminal,, 
when a checkpoint was executed, as: 

♦CHECKPOINT COMMAND COMPLETE *68176/105010*SIMPLE*TAPE50 

where *SIMPLE indicates simple checkpoint, and *TAPE50 indicates 
that the volume serial of the system log tape was tape 50. The 
checkpoint number specifies Julian date and time of day 
(yyddd/hhmmss) . 



BLDQ FORMAT ALL 



SER 



The failure of the IMS/360 or Operating System/360 system may 
have included a failure of the message queue data sets,. In this 
situation, the emergency restart command with FORMAT ALL and BLDQ 
operands should be employed. This command causes all of the 
message queue data sets to be formatted. It also causes all 
messages that have not been processed or transmitted to be 
reloaded from old system log tapes to the proper message queue 
data set. Emergency restart with BLDQ and FORMAT ALL operands 
requires the IMS/360 system to be restarted from the last cold 
start or last system termination where the message queue data 
sets were dumped (that is, /CHECKPOINT PURGE or /CHECKPOINT 
DUMPQ) . If the emergency restart is performed from a previous 
cold start, the checkpoint number must be 0. 



means that the six-character serial number of the tape on which 

the checkpoint number resides may be specified. Any number of / 

serial numbers may be specified. However, the command may be no ( 

longer than one line of typing. This operand is optional because ^ 

the information may be entered through a dd card for the old log 

tape if procedures are not used for IMS/360. 



TERMINAL 



is an optional operand. If TERMINAL is specified, the latest 
terminal security specifications from the user's IMS.RESLIB 
library (generated by the IMS/ 360 Security Maintenance Program) 
will be operational at completion of this emergency restart. 

PASSWORD 

is an optional operand. If PASSWORD is specified, the latest 
password security specifications from the user's IMS.RESLIB 
library (generated by the IMS/360 Security Maintenance Program) 
will be operational at completion of this emergency restart. 

Examples of ERE START Commands 

See Chapter 5 for uses of emergency restart commands. 

DATA BASE RECOVERY COMMAND 

The final capability of the restart facilities of IMS/360 is data 
base recovery. Data base recovery is used to rebuild or recreate a data 
base used for message processing. A /DBRECOVERY command specifying the 
data base names and the volume serial numbers of the log tapes to be 
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used in reconstruction is issued from the master terminal, 
of the /DBRECOVERY command is: 



The format 



/DBRECOVERY 



DATABASE name , . . . name 

1 n 



[ (Password)] 



SER number , . . . number 

1 n 



n TAPE \\ 

[\resend/J 



L J 



where ; 



DATABASE 



SER 



TAPE 



means that the DATABASE operand may have multiple names to allow 
multiple data base reconstruction. 



specifies the six-character volume serial numbers since the last 
dump of the named data base. 



specifies that all output messages resultant from reprocessing 
transactions to recover the data bases specified will only be 
written on the log tape. The messages will not be queued for 
output. See below. 



RESEND 



specifies that all output messages resultant from reprocessing 
transactions to recover the data bases will be enqueued for 
output and written to the tape log. See below. 

If neither RESEND nor TAPE is specified, all output messages 
resultant from reprocessing transactions to recover the data bases 
specified are discarded by the system. Neither queuing nor logging of 
the messages occurs. 

The data base recovery concept involves the periodic dumping of each 
data base with the /DBDUMP command. This command is part of the 
checkpoint facility of IMS/360. The /DBDUMP command causes a copy of a 
data base to be created as an HSAM tape data base. 

The data base to be recreated must be restored as of the last dumped 
copy. This is accomplished by: 

1. Issuing a /DBDUMP command with STOP operand to halt all 
processing against the data base 

2. Restoring the data base to its state of the last dumped copy. A 
user-supplied batch program executed in a Type 3 processing 
region is employed. 

3. Employing the /DBRECOVERY command to cause the reprocessing of 
all teleprocessing transactions since the last DBDUMP 
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EXAMPLE OF DBRECOVERY COMMAND 

See Chapter 5 for uses of the data base recovery command. 

DATA BASE LOG AND NO LOG COMMANDS 

/DBLOG and /DBNOLOG are two commands that enable the user of IMS/360 
to dynamically specify whether he desires the changes (inserts, 
deletions, and updates) to a given data base to be logged on the system 
log tape. Entry of either of these commands would normally be 
restricted to the master terminal but could be allowed from any of the 
remote terminals. The formats are: 



DATABASE 



name , . . . name 
1 n 

ALL 



/DBLOG 

or 
/DBNOLOG 

[ (Password) ] 



L J 



where : 

DATABASE 

is the operand indicating the data bases that are to be either 
logged or not logged. Multiple names or the operand ALL 
(implying all data bases specified at system definition time) can 
be specified. This command is used to modify the conditions 
under which logging is performed as defined at system definition 
time . 

The use of data base modification logging is employed during 
emergency restart if a message processing program was in execution at 
the time of system failure and the message processing program had 
modified data bases. During emergency restart, the data base 
modifications previously logged are used to restore the accuracy of the 
data base. 



EXAMPLES OF DBLOG AND DBNOLOG COMMANDS 
EXAMPLE 1: 

• Entry MT: /DBLOG DATABASE TREEFARM 

• Response MT: *DBLOG COMMAND COMPLETED 



• Response RT: 



NONE 



Explanation : /DBLOG starts data base segment 
logging, which allows backout of data base 
modifications during emergency restart. MT means 
master terminal. RT means remote terminal. 
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EXAMPLE 2: 

• Entry MT: /DBNOLOG DATABASE FOREST 

• Response MT: *DBNOLOG COMMAND COMPLETED 

• Response RT: NONE 



Explanation ; /DBNOLOG stops data base segment 
logging. 
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CHAPTER H. IMS/360 REMOTE TERMINAL COMMANDS AND EXECUTION 



Even though the following IMS/360 coinmancls are designated as remote 
terminal commands, they can also be used at the master terminal. The 
same general format is followed as previously described under "Master 
Terminal Commands" . Correction of remote terminal commands is given and 
keyword definitions are defined before the additional commands are 
given. 

References to physical terminals in the following discussions refer 
to the relative physical terminal on the line; that is, the first 
physical terminal on any line is always physical terminal 1 (PTERMl) ; 
the second, physical terminal 2 (PTERM2); etc. 



REMOTE TERMINAL COMMANDS 



CORRECTION OF REMOTE TERMINAL COMMANDS 

The following are methods to be used in case an error has been made 
when entering a remote terminal command: 

Backspacing - If the EOB or CR (carriage- return) key has not been 
depressed, a typing error may be corrected by depressing the 
backspace key to the incorrect character, retyping it correctly, 
and retyping all subsequent characters. 

Single line deletion - If it is necessary to delete a typed line, 
** must be typed before the EOB or CR key is depressed. 



REMOTE TERMINAL COMMAND KEYWORD DEFINITIONS 

Since several of the commands utilize the same keywords and 
parameters, reference should be made to the following directory when 
reviewing the commands: 



LINE 



PTERM 



LTERM 



TRAN 



is the keyword referring to a communication line; correct 
parameters are one- to three-character line numbers. 



is a keyword referring to a relative physical terminal; correct 
parameter is a number corresponding to the relative position of 
the terminal on the line. 



is a keyword referring to a logical terminal; correct parameters 
are one- to eight-character logical terminal names. 



is a keyword referring to a transaction code; correct parameters 
are one- to eight-alphameric-character transaction codes. 
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PROGRAM 



is a keyword referring to a program; correct parameters are one- 
to eight- alphameric- character program names. 



DATABASE 



is a keyword referring to a data base; correct parameters are 
one- to eight-alphameric-character data base names. 
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5U.2 



ALL 



may be used as a parameter with many keywords. The specific 
acceptable uses of this parameter are noted in the descriptions 
of the individual commands. 



PI, P2, etc. 



are abbreviations used to designate possible parameters in the 
descriptions of the various verbs. 



REMOTE TERMINAL KEYWORD SYNONYMS 

The following table relates the keywords used in the remote terminal 
commands to their allowable synonyms. 




DATABASE 

LINE 

LTERM 

PROGRAM 

PTERM 

TRAN 



DATABASES, DB, DBS 

LINES 

LTERMS 

PROGRAMS, PROG, PROGS, PGM, PGMS 

PTERMS 

TRANS, TRANSACTION, TRANSACTIONS, 

TRANCODE, TRANCODES 









REMOTE TERMINAL NULL WORDS 

The following words are considered null words. For purposes of 
clarity, at the user's discretion, they may be used within commands at 
any time. 

AFTER 

FOR 

SECURITY 

TO 

ON 

MODE 



TERMINAL COMMAND SYNTAX 

The syntax for all terminal command parameter descriptions is much 
like that of Operating System/360: 

1. Words written in all capital letters must appear exactly as 
written. 

2. Words written in lowercase letters are to be replaced by a 
user-specified value. 

3. Enclosing a parameter in brackets indicates that it is optional. 
If more than one parameter is thus enclosed, either all must be 
present or all must be omitted. 



55 



Enclosing a group of parameters in braces on several lines 
indicates that a choice is to be made of one of the lines of 
parameters . 



The symbols [ 1 ,, { > » and , . . . are used as an aid in defining 
the instructions. THESE SYMBOLS ARE NOT CODED; they are only to 
indicate how an instruction may be written. 

[ ] indicates optional operands. The operand enclosed in the 

brackets (for example [VL] ) may be coded or not, depending on 
whether the associated option is desired. If more than one 
item is enclosed in brackets (for example, 

[reread"! ) , one or more may be coded. 
leaveJ 

{ } indicates that a choice must be made. One of the operands 
from the vertical stack within braces (for example, 
(input )) must be coded, depending on which of the 
\outputj 
associated services is desired. 

,,.. .indicates that more than one set of operands may be 
designated in the same instruction. 



LOCK AND UNLOCK COMMANDS 

These two commands are discussed together, since they are opposites. 
For example, /LOCK stops the sending and receiving of messages relative 
to a particular communications line or terminal, stops the scheduling of 
messages containing a specific transaction code, stops the scheduling of 
a specific program, and/or stops the, scheduling or use of a given data 
base. This command allows the queuing of output messages relative to a 
particular communications line or terminal and/or allows the queuing of 
messages containing a specific transaction code. Therefore,, 
functionally,, /LOCK is similar to /PSTOP in that it allows queuing. 

If the terminals are on a switched network, these are the LOCK and 
UNLOCK command considerations: an implied /UNLOCK command is processed 
against a switched network PTERM and inquiry logical terminal whenever a 
physical or logical terminal disconnect occurs between a remote terminal 
and the IMS/360 system. Subpool logical terminals, however,, are not 
affected by a disconnect. 



1 COMMAND 


TERMINAL/LINE 


TRANSACTION 


PROG 


DATABASE 




1 1 
REC| SENDJQ 0/P 

1 1 


SCHED 1 Q 


EXECUTE 


USE 


1 /LOCK 


1 1 

N0| NO I YES 

1 1 


NO 1 YES 


NO 


NO 


1 /UNLOCK 


1 1 
YES| YES 1 YES 

1 1 


YES 1 YES 


YES 


YES 
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where : 

REC allows receipt of input messages. 

SEND initiates sending of output messages. 

Q O/P allows output message queuing from processing. 

SCHED allows scheduling of messages for processing. 

Q allows input queuing of messages. 

EXECUTE allows use of a program for processing messages. 

USE allows use of data base for processing messages. 

Note that /START and /UNLOCK, /STOP and /LOCK, or /PSTOP and /LOCK 
are not the same. Entry of these commands would normally be restricted 
to the master terminal but could be allowed from any remote terminal. 
/LOCK and /UNLOCK, relative to a physical terminal, are applicable only 
to the physical terminal from which the command' is entered. These two 
commands (/LOCK and /UNLOCK), relative to logical terminals, are 
applicable only to logical terminals that are assigned to the physical 
terminal from which the command is entered. The objective of the /LOCK 
command is to allow the terminal user to secure a specific physical 
terminal, one or more logical terminals associated with the user's 
specific physical terminal, one or more data bases, one or more 
programs, and/or one or more transaction codes. 

The following /LOCK and /UNLOCK formats are acceptable: 



/LOCK 

or 
/UNLOCK 

[ (Password) ] 



PTERM [ (Password) ] 



LTERM ALL (See Note) 



LTERM 
TRAN 
PROGRAM 
DATABASE/ 



PI [ (Password) ] ,P2 [(Password) ] 
. . . .Pn[ (Password) ] 



Note: /LOCK LTERM ALL is the only acceptable use of the parameter ALL 
relative to these commands. 

where : 



PTERM 



LTERM 



is the operand that secures the user's physical terminal. Note 
that no keyword parameters are acceptable, since the user can 
lock only his own physical terminal. 



is the operand that secures one or more logical terminals 
associated with the user's physical terminal. 
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TRAN 

is the operand that secures one or more transaction codes. 

PROGRAM 

is the operand that secures one or more programs. 
DATABASE 

is the operand that secures one or more data bases. 

EXAMPLES OF LOCK AND UNLOCK COMMANDS 
EXAMPLE 1: 

• Entry RT: /LOCK TRAN SEED 

• Response RT: *LOCK COMMAND COMPLETED 

Explanation ; /LOCK with keyword TRAN means do 
not schedule this transaction code. If a 
particular transaction code cannot be processed 
correctly, use this command at the remote 
terminal to ensure that this transaction code is 
not scheduled. RT means remote terminal. 

EXAMPLE 2: 

• Entry RT: /LOCK DATABASE TREEFARM 

• Response RT: *LOCK COMMAND COMPLETED 



Explanation ; /LOCK with keyword DATABASE means 
do not schedule any program that uses this data 
base. If a particular data base is not correct, 
use this command at the remote terminal to ensure 
that no program is scheduled that uses this data 
base. 



EXAMPLE 3: 



• Entry RT: /LOCK PTERM 

• Response RT: *LOCK COMMAND COMPLETED 



Explanation : /LOCK with keyword PTERM means 
queue output, but do not send to this physical 
terminal. PTERM applies to the physical terminal 
into which the command is entered. A password 
may be included with the keyword PTERM; no 
parameters are acceptable. /LOCK and /UNLOCK are 
used with nonimmediate- response- type messages 
only. The user can enter a series of 
nonimmediate-response-type messages and /LOCK his 
terminal. No response will be printed on the 
terminal until such time as the terminal is 
unlocked (exception: system messages will always 
be printed) . 
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EXAMPLE a: 

• Entry RT: /LOCK LTERM ALL 

• Response RT: *LOCK COMMAND COMPLETED 



Explanation ; /LOCK with keyword LTERM queues 
output, but does not send to these logical 
terminals. These commands are used with 
nonimmediate- response- type messages only. The 
user can enter a series of nonimraediate- 
response-type messages and /LOCK his logical 
terminal. This normally implies that the 
messages must be secured by logical terminal, 
since the user must know what logical terminal or 
terminals to lock. No responses will be printed 
on the terminal until such time as the terminal 
is unlocked (exception: system messages will 
always be printed) . 



EXAMPLE 5: 



• Entry RT: /LOCK PROGRT^ APPLETREEl 

• Response RT: *LOCK COMMAND COMPLETED 



Explanation ; /LOCK with keyword PROGRAM means do 
not schedule this program. If a particular 
program cannot be executed correctly, use this 
command at the remote terminal to ensure that 
this program is not scheduled or used. 



EXAMPLE 6: 



• Entry RT: /UNLOCK TRAN SEED 

• Response RT: *aNLOCK COMMAND COMPLETED 



Explanation ; /UNLOCK with keyword TRAN means 
schedule this transaction code. RT means remote 
terminal. 



EXAMPLE 7: 



• Entry RT: /UNLOCK PROGRT^ APPLETREEl 

• Response RT; *UNLOCK COMMAND COMPLETED 



Explanation ; /UNLOCK with keyword PROGRAM means 
schedule this program. 



EXAMPLE 8: 



• Entry RT; /UNLOCK DATABASE TREEFARM 

• Response RT: *UNLOCK COMMAND COMPLETED 



Explanation ; /UNLOCK with keyword DATABASE means 
a program may be scheduled that uses this data 
base. 
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EXAMPLE 9: 



• Entry RT: /UNLOCK PTERM 



• Response RT: *UNLOCK COMMAND COMPLETED 



Explanation ; /UNLOCK with keyword PTERM means 
queue output and send output to this physical 
terminal. PTERM applies to the physical terminal 
into which the command is entered. A password 
may be included with the keyword PTERM; no 
parameters are acceptable. /LOCK and /UNLOCK are 
used with nonimmediate-response-type messages 
only. The user can enter a series of 
nonimmediate-response-type messages and /LOCK his 
terminal. No responses will be printed on the 
terminal until such time as the terminal is 
unlocked (exception: system messages will always 
be printed) . 



EXAMPLE 10: 



• Entry RT: /UNLOCK LTERM ALL 

• Response RT: *UNI/DCK COMMAND COMPLETED 



Explanation : /UNLOCK with keyword LTERM means 
queue output and send output to these logical 
terminals . 



BROADCAST COMMAND 

Entry of this command would normally be restricted to the master 
terminal but could be allowed from any remote terminal. The command is 
used to transmit a keyed warning or informational message to one or more 
terminals. The message can be only one line in length. An end-of-block 
key must be depressed prior to the keying of the message to be 
broadcast. 

The format of the /BROADCAST command is: 



/^ 



[ (Password) ] 



/BROADCAST 




[LTERM] 



Pl,...Pn(see note 1)1 



ALL (see note 2) 
PTERM ALL 

ALL 
LINE JPl 



>(EOB) 



PI PTERM 



r 



(See note 3)) 



(P2, . . .Pn(see note 4)) 



YOUR MESSAGE 



(EOB) 
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Note 1. This form of the broadcast command results in the 

transmission of the broadcast message to the physical 
terminals to which terminals Pl,...Pn are assigned. 

Note 2. This form of the broadcast command results in the 

transmission of the broadcast message to all the physical 
terminals in the system. 

Note 3. This form of the broadcast command results in the 

transmission of the broadcast message to all the physical 
terminals located on line PI. Multiple line parameters are 
acceptable when using these two forms. 

Note U. This fotm of the broadcast command results in the 

transmission of the broadcast message to physical terminals 
P2, ...Pn located on line PI. 



EXAMPLES OF BROADCAST COMMAND 
EXAMPLE 1: 

• Entry MT: /BROADCAST TO ALL. (EOB) 

system will shutdown at 5. (EOB) 

• Response MT: * BROADCAST COMMAND COMPLETED 

• Response RT: SYSTEM WILL SHUTDOWN AT 5. 

Explanation ; /BROADCAST, in this case, means 
transmit the message to all physical teinninals, 
MT means master terminal and RT means remote 
terminal . 

EXAMPLE 2: 

• Entry MT: /BROADCAST TO LTERM APPLE, TREE (EOB) 

DON'T USE PGM GREENTREE. (EOB) 

• Response MT: ♦BROADCAST COMMAND COMPLETED 

• Response RT: DON'T USE PGM GREENTREE. 



Explanation : /BROADCAST with keyword LTERM means 
transmit the message to only those physical 
terminals which have these logical terminal 
names. 



EXAMPLE 3: 



• Entry MT: /BROADCAST TO LINE 13 PTERM ALL (EOB) 

EXPECT DEMO YOUR LINE AT 9. (EOB) 

• Response MT: *BROADCAST COMMAND COMPLETED 

• Response RT: EXPECT DEMO YOUR LINE AT 9. 



Explanation : /BROADCAST with keywords LINE and 
PTERM results in the transmission of the message 
to all physical terminals on LINE 13. 
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TEST COMMAND 

This command can apply only to the user's terminal. It is used to 
place the user's ovm terminal into test mode. No independent output 
messages will be transmitted to the user's terminal. Any input messages 
that are entered into the user's terminal will be transmitted back to 
the user's terminal. After the /TEST verb is entered, the user's 
terminal will remain in the test mode until an /END command has been 
received from the user's terminal. There are no acceptable keywords or 
parameters. The only acceptable format is: 



/TEST 

t (Password) 3 



-_j 



EXT^PLES OF TEST COMMAND 
EXAMPLE 1: 

• Entry RT: /TEST 

• Response RT: *TEST COMMAND COMPLETED 

• Entry RT: NOW IS THE TIME TO COME TO THE AID 

• Response RT: NOW IS THE TIME TO COME TO THE AID 



Explanation : /TEST implies that no independent 
messages will be transmitted to the user's 
terminal. Messages entered into the user's 
terminal are transmitted back to the user's 
terminal. The exception is shown in Example 2. 
RT means remote terminal. 



EXAMPLE 2; 



• Entry RT: /TEST 

• Response RT: *TEST COMMAND COMPLETED 

• Entry RT: 99999074A 

• Response RT: 123U56c890 spaceSbksp 

c 
If 
1 
2 
3 



Explanation : same as the explanation in Example 
1, except that the entry is an IBM FE terminal 
test as described in the BTAM SRL. The response 
in this case is different from the entry and 
exercises the terminal as shown. 



r 
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EXCLUSIVE COMMAND 

This command is used to place the user's own terminal into exclusive 
use or inquiry mode. The user enters this mode, through the entry of 
the /EXCLUSIVE verb, if he desires to enter one or more inquiries into 
his terminal and wants to receive only the responses to his inquiries, 
without receiving output from other miscellaneous sources. Scheduling 
and queuing are allowed to continue. After this command has been 
entered, the user's terminal will remain in the inquiry mode until an 
/END command has been received from the user's terminal. There are no 
acceptable keywords or parameters . 

Since messages are displayed as soon as possible after queuing, the 
/EXCLUSIVE command is recommended for proper operation of the 2260 
terminal. It will protect the screen of information from being overlaid 
by message switching, system messages, and messages generated by 
processing programs initiated by other terminals while the operator is 
viewing a response he initated. These messages will remain on the queue 
until a /END command is entered. 



The only acceptable format is: 




EXAMPLE OF EXCLUSIVE COMMAND 

• Entry RT: /EXCLUSIVE 

• Response RT: *EXCLUSIVE COMMAND COMPLETED 



Explanation : /EXCLUSIVE places the user's 
terminal into exclusive use or inquiry mode- 
means remote terminal. 



RT 



END COMMAND 

The /END command is used to terminate the mode that was originally 
initiated through the entry of /TEST or /EXCLUSIVE. This command can 
apply only to the user's terminal. There are no acceptable key words or 
parameters. The only acceptable format is: 
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EXAMPLE OF END COMMAND 

• Entry RT: /END 

• Response RT: either 

♦TEST MODE ENDED (/TEST) 

or 

♦EXCLUSIVE MODE ENDED (/EXCLUSIVE) 

or 

♦END COMMAND COMPLETED 



Explanation : /END terminates the mode initiated 
through the /TEST or /EXCLUSIVE command. RT 
means remote terminal. 



LOG COMMAND 



This terminal command is limited to one line in length, as is any 
command (slash-type) message. The function of the command is to cause 
the contents of the entered message to be logged, not processed by a 
program, with the slash (/LOG) being the first character logged. This 
command applies only to the currently entered message line and does not 
establish a continuing operational mode. There are no acceptable 
keywords or parameters as such. One or more spaces must separate the 
verb from the first letter of the message to be logged. The first word 
of the message, following the /LOG verb, may be a transaction code. To 
log the message "Today is Monday", the following format would be 
acceptable: 

/LOG TODAY IS MONDAY 



i /LOG j [(Password)] text | 

I __J I 

where: 
text 

means the alphameric character message to be logged. 

EXAMPLE OF LOG COMMAND 

• Entry MT or RT: /LOG TODAY IS MONDAY 

• Response MT or RT: ♦LOG COMMAND COMPLETED 

Explanation : /LOG causes contents of the message 
at this terminal to be logged but not processed 
by a program. It applies only to the currently 
entered message line and does not establish a 
continuing operational mode. MT means master 
terminal and RT means remote terminal. 



( 
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CANCEL COMMAND 

The function of this conanand is to cause the cancellation of all 
lines of a multiple-line message that is currently being entered (prior 
to EOT) into this same terminal. Note that this command causes the 
cancellation of a complete message. It cannot be used to cancel a 
single-line input message. An erroneous single line can be canceled 
through the entry of two asterisks (*♦), immediately followed by an 
end-of-block (EOB) character, at the end of the segment to be canceled. 
There are no acceptable keywords or parameters. The only acceptable 
format is the verb itself, as follows: 



/CANCEL 



[ (Password) ] 



EXAMPLE OF CANCEL COMMAND 



• Entry MT or RT: /CANCEL 



Response RT or MT: *CANCEL COMMAND COMPLETED 



Explanation : /CANCEL is used to cause 
cancellation of a complete message currently 
being entered into this same terminal. MT means 
master terminal and RT means remote terminal. 



SET COMMAND 



This terminal command sets the destination of all messages entered 
into this terminal to another terminal (/SET MODE to LTERM master) or to 
a particular transaction code (/SET MODE to TRAN IMS) (password) . It 
may be changed by /RESET, /START LINE for present terminal, or by the 
/lAM command. If the transaction is secured by password, checking is 
done at the time of processing the command. The allowable format is: 



/SET 



[ (Password) ] 



[MODE] (TRAN name) t (Password)] 
(LTERM name/ 






L . . J 



EXAMPLE OF SET COMMAND 
EXAMPLE 1: 

• Entry RT: /SET MODE TO LTERM MASTER 

• Response RT: *SET COMMAND COMPLETED 



Explanation : /SET with keyword LTERM allows the 
setting of a destination mode for messages 
entered thereafter into the entering physical 
terminal. LTERM relates to message switching. 
In this case, any message entered hereafter from 
this terminal would not have to have a 
destination terminal code name at the beginning 
of the text of the message. 
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EXAMPLE 2: 

• Entry RT: /SET MODE TO TRAN IMS (Password) 

• Response RT: *SET COMMAND COMPLETED 



Explanation ; /SET with keyword TRAN allows the 
setting of a destination mode for messages 
entered thereafter into the entering physical 
terminal. TRAN relates to a normal message where 
a transaction code is referenced by the first 
eight characters in the first segment of the 
message. By the entering of this command, any 
message entered hereafter cannot have a 
transaction code at the start of the text of the 
message. RT means remote terminal. 



RESET COMMAND 

This terminal command eliminates the preset destination invoked by 
the /SET command. 



EXAMPLE. OF RESET COMMAND 

• Entry RT: /RESET 

• Response RT: *RESET COMMAND COMPLETED 



Explanation : /RESET negates the action of the 
/SET command. RT means remote terminal. 



RDISPLAY COMMAND 

The /RDISPLAY command provides the ability from a remote terminal to 
display the logical terminal name, the physical terminal address, and 
the line number assigned as the master terminal. 



i /RDISPLAY i [(Password)] MASTER | 

I I i 

L . J 

where : 

MASTER 

is a part of the command that requests the identity of the 
terminal designated as master. 
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EXAMPLE OF /RDISPLAY COMM/^ND 
• Entry RT: /RDISPLAY MASTER 



• Response RT: 



LTERM MASTER 
PTERM 3-1 
♦69010/123704 

Explanation ; /RDISPLAY MASTER displays the 
identification of the master terminal. RT means 
remote terminal. 



lAM COMMAND 

The /lAM command applies only to a switched communications network on 
dialup facilities. This command must be entered before any input 
transaction codes or other remote terminal commands will be accepted. 
The following formats are acceptable: 



/I7^ 



[ (Password) ] 



LTERM PI [(Password)] 



LTERM P2 [(Password)] 



PTERM [(Passwordl)] LTERM PI [ (Password2) ] 



L J 



where: 



LTERM PI 



means that this command automatically accomplishes the attachment 
of pool logical terminal PI to the switched (dialup) 
communications line over which the call was received from the 
remote (physical) terminal. 

LTERM P2 

means that this command automatically accomplishes the logical 
attachment of the inquiry logical terminal to the switched 
(dialup) communications line over which the call was received 
from the remote (physical) terminal. Only the first four 
characters of the inquiry logical terminal name are compared with 
the first four characters of the P2 parameters. Reference should 
be made to the IMS/360 Operations Manual, Volume I - Systems 
Operation for definition of an inquiry logical terminal. 

PTERM (Passwordl) LTERM Pl(Password2) 

, has the same meaning as the above operand, but accomplishes the 
attachment of all logical terminals associated with the subpool 
in which PI exists. 
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EXAMPLES OF lAM COMMAND 
EXAMPLE 1: 

• Entry RT: /I AM LTERM *1050AA1 

• Response RT: *IAM COMMAND COMPLETED 



Explanation ; /I AM with keyword LTERM is the form 
LTERM PI as described above. This allows a 
terminal user at a switched line terminal to 
identify himself. (Required if a switched 
(dialup) line terminal.) RT means remote 
terminal. 



EXAMPLE 2: 



• Entry RT: /lAM LTERM INQUIRY 

• Response RT: *IAM COMMAND COMPLETED 



Explanation : /lAM with keyword LTERM is the form 
LTERM P2 described above. This example 
illustrates signon procedure for a switched line 
terminal signing on for entry of response- type, 
nonupdate-type transactions. Only the first four 
characters of the LTERM parameters are 
significant. 



EXAMPLE 3: 



Entry RT: /lAM PTERM (DOLLY) LTERM SUE (GIRL) 
Response RT: *IAM COMMAND COMPLETED 



V 



Explanation ; /lAM with keywords PTERM and LTERM 
is the third form of the lAM command. It 
accomplishes the basic signon capabilities. 

REMOTE TERMINAL STARTUP 

Refer to the appropriate IBM SRL manual for instructions on the use 
of 1050, 2740, or 2260 terminals. 

TERMINAL STARTUP 

It is assumed that the remote terminal power switch has been turned 
on so that, when the /START LINE XXX command is completed by the IMS/360 
master terminal, the message on the remote terminal will be: 

♦TERMINAL STARTED 

Before the communication line is started for that physical terminal, 
the keyboard will be locked. Only after that message is received can 
any entry be made into the remote terminal. 

REMOTE TERMINAL INPUT FORMATS 

Normal Message Format 

Probably the majority of remote terminal inputs will be with the 
IMS/360 normal message format: 
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w^ j transaction | (Password) j TEXT j 

ri code 1 I m 

intt ' ' ' '^See 

note I . J . 

1. J note 

^^1°^^ below) 

where: 

transaction code 

is the one- to eight-character alphameric code that is defined at 
system definition time. It may not start with a / (slash). The 
special characters embedded blank, dash, equal sign, comma, and 
period are not allowed. 

(Password) 

is a password (when security provisions require) that must be 
entered with the transaction code. It must be enclosed in 
parentheses (with 1050 terminals, bypass and restore characters 
are also acceptable) . 

TEXT 

is the input message- It may be single or multiple lines in 
length followed by an EOB after each line and an EOT after 
multiple-line messages for 1050 or 2740 terminals. 

Note : The input message for a 2260 is considered to be that data 

contained between the START MI symbol (►) and the position of the 
CURSOR (!) symbol at the time the ENTER key is depressed. These 
two symbols are used only when a 2260 Display Station is used as 
the input device. The 1050 and 27 40 terminals do not require 
these symbols. All other data displayed on the screen at this 
time is ignored and is not transmitted to the CPU. If no START 
MI (►) symbol is displayed at the time the ENTER key is 
depressed, no data is sent to the CPU. New-line characters may 
be used to separate lines of a 2260 message. 

Message Switching Format 

Another input format that may be entered from a remote terminal is 
the message switching format: 

r 1 

I I I 

w I logical terminal | TEXT | 

^ I name | \WM 

L . J 

where : 

logical terminal name 

represents the terminal on which the message will be printed, if 
the input message starts with a logical terminal name. The 
allowable logical terminal names are to be specified by the 
Application Programming function. 
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TEXT 



is the input message. It may be single or multiple lines in 
length. Each line must be followed by an EOB; the last line must 
end with an EOB and an EOT. 



Command Message Format 

The command message format is detailed in Chapter 3. This is the 
general format: 



I /verb I (Password) KEYWORD PI KEYWORD P2 , P3 . COMMENTS {■ 



SWITCHED (DIALUP) TERMINAL STARTUP 

Operation of the switched (dialup) terminal is the same as the 
nonswitched or hardwired terminal, with these exceptions: 

• Turn power on to the terminal. 

• Check for proper positioning of all assignment and function switches 
located on the 1052/1053 switch panel. 

Suggested for 1052 keyboard entry are: 



Attend 


ON 


Master 


OFF 


Printer 1 


Send Rec 


Keyboard 


Send 


EOB 


Auto 


Test 


OFF 


Single Cycle 


OFF 


Rdr Stop 


OFF 



• Depress Line Reset Key (1050) . 

• Depress Bid Request Key (1050). 

• Set the data set to talk. 

• Dial the number of the computer. 

• Listen for the continuous tone. 

• Press the data button on the data set. 

• Enter the /lAM command (see Chapter 3 for details) . Because dialup 
terminals may not always be internally associated with the same 
communication line, IMS/360 includes a recognition feature,. The 
terminal operator is permitted five opport\inities to accomplish a 
valid signon. If, after entry of five messages from the remote 
terminal, the terminal has not been signed on, the terminal will be 
notified that the line is being disconnected; the line will be 
disconnected and restored to answering status. 

• The reply will be: 

♦I AM COMMAND COMPLETED 
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Enter any of the preceding three message formats. The switched 
terminal is online. 

Following signon, the terminal will be alternately permitted to 
enter a message and receive an output message from the queue (s) of 
signed-on logical terminals. Terminal operation closely resembles 
that of a nonswitched 1050 terminal, with the exception of the 
handling of transactions defined during IMS/360 system definition as 
single segment transactions. After enqueuing a single segment 
transaction, if no output is queued on the signed-on logical 
terminal (s), the terminal is immediately restored to 'text* mode. 
The operator need not depress the request key to facilitate entry of 
the next message. If no other data is ready to be transmitted, the 
operator should depress 'EOT*. If approximately UO seconds pass 
without input or output of data from or to the remote terminal, the 
terminal will be notified that the line is being disconnected; the 
line will be disconnected and restored to answering status. 



2260 OPERATOR CONSIDERATIONS 

It is recommended that after a transaction is input the operator 
should await his reply, if one is expected, before entering another 
transaction. This will prevent the reply from one program overlaying 
the reply from another before the operator has viewed it. 

Since messages are displayed as soon as possible after queuing, the 
/EXCLUSIVE command is recommended for proper operation of the 2260 
terminal. It will protect the screen of information from being overlaid 
by message switching, system messages, and messages generated by 
processing programs initiated by other terminals while the operator is 
viewing a response he initiated. These messages will remain on the 
queue until a /END command is entered. 



REMOTE TERMINAL TROUBLE PROCEDURE 

When a remote terminal operator believes that he is having trouble, 
that is, he has pressed the bid key on a polled 2740 and received no 
response, or the three lights on a polled 2740 are not observed going on 
and off, he probably should contact the master terminal operator or the 
user's designee to handle trouble reports from remote terminals. First, 
however, a few simple checks should be made. Is the terminal plugged 
in? Is it turned on? Are the switches on the end correctly positioned? 
Are they properly installed? 

Another common trouble occurs when the master terminal operator has 
not broadcast a message that the system has had to be shut down, and the 
remote terminal keyboard is locked. 

When using dialup facilities there will be no response when the 
system is shut down for an emergency reason and the dialup terminal was 
not online when the master terminal operator broadcast a message 
concerning the problem. 

All IMS/360 teleprocessing installations must have a procedure for 
handling problems with remote terminals. A suggested procedure is: 

1. Have the remote terminal operator call the master terminal 
operator and inform him that his terminal is not performing 
correctly. 

2. The master terminal operator may ask the following questions: 
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3. 



• What is the nature of the problem? 

• Is the terminal polling (if station control terminal)? 

• Is the paper properly inserted in the terminal? 

• Is the terminal on and in the communication (MPLX) mode? 
(With the 1050 terminal, check the appropriate SRL for 
correct settings . ) 

• If possible, have the remote operator use the /TEST command 
and input a message, observing whether a reply back is the 
same as that which was sent. 

If the remote terminal user's problem cannot be solved 
immediately, the master terminal operator should probably ask the 
necessary questions to fill out the first three columns of a form 
that may be designated "Log of Reported IMS/360 Remote Terminal 
Failures" (see Figure 5) . 




DATE £ 
TIME 



TYPE OF FAILURE 




F.E. 
CONTACT 



F.E. WHO 

CORRECTED 

FAILURE 



DATE g 

TIME 

SERVICED 



( 



Figure 5. Log of reported IMS/360 remote terminal failures 

4. The Master Terminal Operator then notifies an IBM field engineer 
of the problem and writes the field engineer's name on the form. 



( 
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CHAPTER 5. IMS/360 SYSTEM EXECUTION 



This chapter contains the information necessary for the Machine 
Operations function to execute IMS/360. Such topics as readying 
IMS/360, starting IMS/360, stopping IMS/360, data base maintenance and 
reconstruction, and the IMS/360 log tape are discussed. Examples are 
furnished in this chapter to emphasize individual points. 



READYING MACHINE OPERATIONS FOR IMS/360 

Before IMS/360 can be run in the machine room, there are a number of 
items that the Machine Operations function can do to assist the Systems 
Operation function up until IPL (Initial Program Load) time. 



41 i4[ :4i :ti ;» 4t 9» # :» see « « Xt * ♦ 

* GET ft£LEAS£ * 

* * 



♦ * 

♦ MCVE IMS/36C "^ 

♦ TC DIRECT * 

♦ ACCESS * 

♦ DEVICES * 

i 



♦ S-YSTE^i DEFINE* 

* IMS/360 * 
» * 



A release of IMS/360 was procured 
on either 7- or 9-track tapes 
(two) . 



2. 



lEHMOVE Utility must be employed 
to transfer these libraries to 
direct access devices. 

( Note; These first two items are 
detailed in the IMS/360 
Operations Manual, Volume I - 
Systems Operation , Chapter 2 . ) 



3. 



IMS/360 must be defined to the 
user's data processing 
environment . 
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u. 



I J 

FfcKFORM 

IMS/360 

SYSTEM 
■■ CtflKniLH 



*FiMSH SYSTEM* 
* DcflMTICN * 



****** *5;t3^5i«** 2?** 



MGVfc CSAM 

CHAivKEL cND 

APPcNCAGE 



*************** 



« ;<i :«>*** :i< « ;^ ^ 5? *** * 

*HELIi\K- EDIT * 

* SVC'3 TU OS * 

* MCLcUS * 

* * 

*«*«:** ***i;s***** 



i 



5. 



6. 



7. 



An IMS/360 utility, IMS/360 
System Definition, must be 
performed either on the computer 
on which IMS/360 willi be 
operating or on an alternate 
machine. 



System definition is a two-stage 
operation: The Stage 1 output is 
a punched card deck for input to 
Stage 2, which builds the blocks, 
tables, and libraries for use by 
IMS/360. 

(Items 3, 4, and 5 are discussed 
in more detail in the IMS/360 
Systems Operation Manual, Chapter 
2, System Handling, and in 
Chapter U, System Definition.) 



The OSAM (Overflow Sequential 
Access Method, new with IMS/360) 
channel end appendage module must 
be moved into SYSl.SVCLIB. 



Some (three maximum) SVC routines 
must be relink- edited with the 
Operating System/360 nucleus. 



7U 



« ALLLC/iTt ^ 
*SPACe FCK UBD'!' 
*AND PSti LlbS * 
* « 





1'* 

V 


* 


MODULES 


* 


^.3!«*.Jc4:i.:^«-4;«:it*=;i: 


?<* 



4* « « 4 5r * * ■r-!' ** * 

=!« FlNiShLD 

♦ READYING 

♦ If'S/BoO 



f^*: 



♦GG TC lHS/360* 
*Pf<cPRCCESi>iNG* 

4* * *^5>>r*5f*** ** + 



9. 
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11. 



Direct access space must be 
allocated for DBD and PSB 
libraries. If the system is 
online, additional space must be 
allocated for message queue data 
sets. 



Move recommended reentrant 
IMS/360 modules to SYSl.LINKLIB 
in order to place them in MFT 
or MVT link pack at Operating 
System/360 IPL time. 



After the above 9 items are 
accomplished, they need not be 
accomplished again until the 
IMS/360 system definition changes 
or an Operating System/360 system 
generation is performed. 



At this point, the Machine 
Operations function is ready to 
begin the following periodic 
IMS/360 processing techniques. 



STARTING IMS/360 

This discussion assumes that the normal procedures of IPL, readying 
Operating System/360, have been followed according to IBM System/360 
Operating System, Operator's Guide (GC28-6540). 

It is assumed that the recommended procedures have been placed in 
MFT or MVT SYSl.PROCLIB and that a direct access storage device 
reader procedure is being used in accordance with IMS/360 Operations 
Manual, Volume I - Systems Operation . 

The recommended library procedures should have been selected by 
IMS/360 system definition. A list of these procedures follows: 
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Procedure Library 
Member Name 
PSBGEN 

DBDGEN 

IMSCOBOL 



IMSPLI 



DLI BATCH 



IMSCOBGO 



IMSPLIGO 



IMS 



IMSl 



IMSO 



IMSMSG 



IMSBATCH 



SECURITY 



DLITCBL 



DLITPLI 



Descript-ion 

A two-step assemble and link-edit 
procedure to produce program 
specification blocks 

A two-step assemble and link-edit 
procedure to produce data base definition 
blocks 

A two-step compile and link-edit 
procedure for IMS/360 applications 
written in COBOL 

A two-step compile and link-edit 
procedure for IMS/360 applications 
written in PL/I 

A one-step execution procedure for 
stand-alone Data Language/I Type 3 
processing region 

A three-step compile, link-edit, and go 
procedure combining the procedures 
IMSCOBOL and DLIBATCH 

A three- step compile, link-edit ^ and go 
procedure combining the procedures IMSPLI 
and DLIBATCH 

DASD reader procedure to read IMSO 
procedure into Operating Systera/360 job 
stream from direct access devices 

Execution of IMS/360 Type region, the 
IMS/360 online control program with JCL 
from system input stream 

Execution of IMS/360 Type region, the 
IMS/360 online control program with 
complete JOB PROCEDURE LIBRARY 

Execution of IMS/360 Type 1 region, a 
message processing region 

Execution of IMS/360 Type 2 region, an 
online batch region 

A three- step execution, assembly, and 
link- edit procedure for terminal and 
password security which invokes the 
Security Maintenance Program 

A SYSIN member used by the link steps of 
procedures IMSCOBOL and IMSCOBGO 

A SYSIN member used by the link steps of 
IMSPLI and IMSPLIGO. Note that entry 
point IHESAPD is specified. This 
corresponds to the PARM value 0PT=1 in 
the corresponding compile procedures. 
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) 



Note that the generated procedures accommodate the OS/360-MVT or 
MFT. 



Based on these assumptions, the following are the steps to start 
IMS/360: 



* I PL e 57:160 * 



« SPECIFY * 

SYiSJEM 

* PAkAKETERS * 

*4 **«*«> ******* 



jjij^jfr**«*«**«:{<^(:<: ******* 

* REPL.Y OG, ♦ 
•RAM=01,02» 

» Eoe * 

******* 4 **-^3jt*** 



t^ * 

* CCi\]ilVUfc « 

* eS/360 I PL * 

* PRCGE[>X>RkS ♦ 

* ♦ 
»******)ii*****«* 



i 



IPL Operating System/360 



A message is received back on the 
computer console, SPECIFY SYSTEM 
PARAMETERS . 



Answer the message on the System/360 
console by entering REPLY 
00,»RAM=01,02* . This places the 
modules defined by two procedures in 
the MFT or MVT link pack area. 
Refer to the IMS/360 Operations 
Manual, Voliame I - Systems Operation 
for definition of procedures 
lEAIGGOl, IEAIGG02. OS/360 defines 
these procedures by the last two 
digits. 



Continue standard Operating 
System/360 IPL procedures - 
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Is the IMS/360 that is to be started 
a teleprocessing system (online) or 
batch? If batch, go to label BATCH. 



* * BATCH 

* IS Ii^S TO BE * * * 
* STARTtC FOR *> * 

* CNLIN£ OR « * * 
* BATCH? - *** 

* YES 



\ 

V 
IP * * IMSl 

* * 
* * N u vj^^ 

* START REGION * * * 
* C aITH IMSl -> * 

* CR IMS? « * * 

* YES 



IMS V 



LABEL TP: Does Machine Operations 
wish to start IMS/360 Region Type 
(the IMS/360 Control Program Region) 
with JCL from system input stream 
(IMSl) or with the disk reader 
procedure named IMS? If IMSl, go to 
label IMSl. 



START IHS 



LABEL IMS: It is assumed that the 
user wishes to start with a complete 
JOB from the procedure library. 
Therefore, enter STT^RT IMS on the 
System/360 console. This causes the 
disk reader procedure named IMS to 
read the JCL procedure named IMSO for 
the IMS/360 control program from the 
procedure library to an Operating 
System/360 SYSIN stream. 



^ 

^ 



IHSQ V 



A IMSO 



I 



LABEL IMSO: The job control language 
statements named IMSO, which are the 
JCL required for the IMS/360 control 
program job, cause that job to be 
placed in the Operating System/360 
input job hold queue. The operator 
must activate the job before it will 
start. IMSO is initially placed in 
the hold queue of Operating 
System/360 to allow coordination of 
the computer workload. 



( 
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READY 

^ 3}c sjt jjc^cji: :^ ^ :^ ::{(:{: :ic 3)e 3!: :jc 3ic :{: :^ ^ :j( ^ 



IMS READY 
« YYDDD/HHMMSS = 



* MASTER * 
* TERMINAL * 

* OPERATIVE ^ 

i(e Xt ^ X( }{< sjc^ }}( X: ::^ A ^ ^ # ^ 



LABEL READY: A message to both the 
master terminal and the Systera/360 
console signifies that the IMS/360 
control program is now ready for 
restart. 



The master terminal is now operative 
and is being polled. 



* ENTER * 

•* /NRE START ♦ 

* CHKPT * 

*^[TERM] [PAS SWORD J^* 



Before any other IMS/360 regions or 
partitions can be started for 
processing, a cold start must be 
entered at the master teirminal (MT) . 
User has an option of including 
terminal and/or password security. 



V 

:(( :^ ;(: :l!c 4! :i(:^ ^ 3;( 3^ :3k :^ :^ ^c ^ 
* * 

* '<=NRESTART * 
* COMMAND IN * 

* PROGRESS * 



Reply from IMS/360 to the master 
terminal. 
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* ^i'iKS COLO « 
* START * 

♦ CCJ'.PLETtO ♦ 



jjtaji «* * 3> Jji « * * **«J^« 

♦ * 

* ENTER /START * 

* REGiCN * 
* * 

jj.*^'* *********** 



♦ *STAHT HSGREG * 
CUKf^ANC IN 
* PROGRESS * 

4:^:^:ifyi.if4it ******* 



I 



A message will be sent to the 
System/360 console asking that a tape 
be mounted at some location. This 
tape is the IMS/360 log tape, which 
is necessary for checkpoint and 
restart of the system. 



After the log tape is mounted and the 
cold start is complete, this is the 
response to the master terminal. 



From the master terminal., enter , 
/START REGION. The IMS/360 command 
invokes the procedure IMSMSG, which 
executes an IMS/360 Type 1 processing 
region (teleprocessing). 



V 



The reply from IMS/360 on the master 
terminal will be *START MSGREG 
COMMAND IN PROGRESS. 
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5|t ;J « ^ :>*««;*« jj. ;>* 4 ****** * 
* ♦ 

* 
*3j(;{.:(cj>:4********* 



H Q AND S 
;«' ihll 



« )j. !(.*:> 4 *«:<. jfr ********** ♦ 
* * 

* * 



* IMS116I * 
MESSAGE ■ 

PRCCESSING 

REGtIGN 

* S7/^R=T£D * 

j^:^«»4t**«4**4*** 



At the same time that the reply goes 
to the MT saying that the start 
message region command is in 
progress, two messages are received 
at the System/360 console. 



The response to these messages is 
RELEASE QUEUE, which specifies that 
all jobs in the input queue are to be 
made available for processing. 



When the message region (Type 1) has 
actually been started, the reply to 
the master terminal is IMS116I 
MESSAGE PROCESSING REGION STARTED. 
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I 

V 

/START LINE 
* ALL * 



V 

» CCf'WANC * 
* CCi^FLETE « 



« * TLRMiiMAL * 

* STARTED * 

* * 



«STAisT HESSAGt* 

* FRGJ* AlL ♦ 
♦SIARTcD TERMS* 



As a result, of the START command, a 
♦TERMINAL STARTED message is enqueued 
on the first logical terminal of each 
physical terminal on the specified 
lines. 



When the reply to the MT is * START 
COMMAND COMPLETE, IMS/360 
teleprocessing has begun. 



The ♦TERMINAL STT^TED message is 
transmitted to all nonswitched remote 
terminals, and the line is 
conditioned to accept input from and 
transmit messages to remote 
terminals. Switched lines will also 
be enabled to answer dialup calls 
placed from remote terminals. 
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* ♦ 

* MAKE UP JCL * 

* * 

* * * « J} s^i 31. jj. :j. sit :;: ^It 3|. * j;t 



//IMSl 

// 

// 



^ READY 

S RCRfCCC — > * 

4 4'3t>J»4*«:»9Ji«;t«;(i<c4 



LABEL IMSl: The option has been 
taken to start the IMS/360 Region 
Type with JCL from a card reader 
system input stream. This is the 
following JCL: 
JOB MSGLEVEL=1 , PRI0RITY=1 3 
EXEC IMS1,REGION=160K, X 
PARM= • OODFSINUCl 

Note that 160K is assumed to be the 
size of the user's system and that 
IMS/360 modules reside in the 
IMS.RESLIB data set. 

Enter START RDR, OOC on System/360 
console when card reader address is 
OOC. Otherwise, specify proper 
reader address. The IMS/360 
procedure named IMSl may be used with 
JOB, JOBLIB, and data base DD cards 
from the card reader. Go to LABEL 
named READY. This job must be a 
single step. 



LABEL BATCH: Is the batch 
environment that is wanted an IMS/360 
Type 2 or Type 3 processing region? 
If Type 3, go to LABEL TYPE 3. 



BATCfc ♦ * 


TYPE 


* * 




* *NL 


*^* 


* li BATCii TYPE - 


* * 


2 CR TYPE 3 


«^> * 


* THIS KEGICN ? * 


* * 


♦ * 


*** 


* * 




* * 




* YES 





TYPE2 V 






PkCVICE JCL 
FL8 T,YP£ 2 

bAJCH 


* 
•A 


*;«♦«*«***«***«'=> 



It is an IMS/360 Type 2 processing 
region that is wanted. Use this JCL 
(invokes IMSBATCH processing) through 
the input stream, start initiator, 
and run in the batch jobs: 
//TYPE 2 JOB 848 name , MSGLEVEL=1 
//JOBLIB DD DSNAME=IMS.RESLIB,DISP=SHR 
// DD DSNAME=IMS.PGMLIB,DISP=SHR 
// EXEC IMSBATCH, X 

// PARM=«2,AAAAAAAA, X 

// BBBBBBBB,CCCCCCCC, X 

// DDDDDDDD* 

Note: The user should refer to 
Chapter U of the IMS/360 Operations 
Manual, Volume I - Systems Operation 
for explanation of the PARM operand. 
Either a JOBLIB or a STEPLIB must be 
provided for execution of the 
IMSBATCH procedure. 
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TYPE3 

4 4 

* PRGVIOt JCL * 

* FCH TYPE 3 * 

* BATCH * 
4 4 
****** Jt**^:!:**** 



3>45!;^;}*«4*«Jj:**** 

*RWN AS NUKMAL* 

* CS/3ijO JCti * 

* * 

;j<:ic**;^*:}i *;!.****** 



Type 3 processing region is run as 
any normal Operating Systein/360 job. 
To use the Data Language/I modules 
for those jobs, DLIBATCH processing 
may be used, and this is the JCL to 
use to invoke DLIBATCH. 
//DLIBATCH JOB MSGLEVEL=1 

//JOBLIB DD DSNAME=IMS.RESLIB,DISP=SHR 
// DD DSNAME=IMS.PGMLIB,DISP=SHR 

Where the application program 
and PSB have the same name, use; 

// EXEC DLIBATCH , PARM= • 3 , PSBNAME * 

Where PSB has a different 
name than the application 
program, use: 

// EXEC DLI BATCH, PARM=« 3, PGMNAME, PSBNAME* 
where PGMNAME equals the 
application program name, and 
PSBNAME equals the PSB 
name. 



Note: DD cards must be appended to 
this DLIBATCH procedure for the data 
sets which represent the physical 
storage of this data base. Either a 
JOBLIB or a STEPLIB must be provided 
for execution of the IMSBATCH 
procedure. 



Run the batch processing program as a 
normal Operating System/360 job. 



TYPES OF RESTART OF IMS /3 60 

The type of IMS/360 restart employed is dependent upon how IMS/360 
was shut down. Figure 6 is a chart showing which restart command should 
be used for the type of checkpoint taken at shutdown. 
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1 1 TYPE OF CHECKPOINT I 

1 RESTART 1 /CHECKPOINT | /CHECKPOINT | /CHECKPOINT | /CHECKPOINT | 
1 1 SIMPLE 1 FREEZE | PURGE | DUMPQ | 

1 1 Sequencel* | | | | 
1 COLD START j /NRE CHKPTO | | \ | 
I 1 [FORMAT 1 i 1 1 
1 1 ^LL] 1 1 1 1 

1 j 1 Sequence2*| | | 
1 WARM START j | /NRE CHKPT# j | | 


1 II 1 Sequences* 1 Sequences*] 
1 WARM START | j j /NRE CHKPT# j /NRE CHKPT#| 
1 III BLDQ 1 BLDQ j 

1 1 Sequenced* 1 j j | 
1 EMERGENCY j /ERE CHKPTtt j j | | 
1 RESTART 1 1 1 1 1 
j (Loss Of 1 1 1 1 1 
1 core only) j | j | | 
1 1 1 1 1 1 

1 1 1 1 1 1 
1 EMERGENCY | | | Sequences* | Sequences* | 
1 RESTART 1 1 1 1 1 
I (Loss of 1 1 |/ERE CHKPT#|/ERE CHKPT#| 
1 message j j j BLDQ j BLDQ | 

I queues) j j j FORMAT ALL| FORMAT ALL| 

II 1 1 1 1 



♦See Figure 7. 
Figure 6. IMS/360 restart relationship to checkpoint 



Normal Restart 



Figure 7 reflects the details of Figure 6: what the types of restart 
are, and what the command entries are. Blocks Al and A2 of Figure 7, 
page 1, summarize the events that are described in detail through the 
READY block in the previous section, "Starting IMS/360". 

In Figure 7 it is assumed that a predefined process symbol, like 
symbol, AU, is the term to be entered into the master terminal. The 
subroutine symbols, like symbol A2, are output messages to the master 
terminal. Figure 7 shows the sequence of events to produce the type of 
restart needed for that particular type of previous shutdown. Figure 7 
details are given in the IMS/360 Operations Manual, Volume I - Systems 
Operation , in Chapter 3, under the section "Restart". 
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*************** 

START 
ttr* ************ 



COLO-START * 



**************^ 



*************** 



*************** 

» 4 

LOAD lHS/360 

» * 

*************** 



*************** 



*************** 



*************** 



*************** 



*************** 



A3 
/ERESTART 

go **** 

* * • 
»> AO * 

♦ » 2» 
**** 



NEW SECURITY 



*************** 
END RESTART 



/NRESTART V 

*************** 
* ENTER » 

* /NRESTART 
* CHECKPOINT 

* DATE/TIME OR 

» « 
*************** 



*************** 

t * 

ENTER 

PASSWORD 

ANO/OR 

► TERMINAL « 

*****^********* 



AS 
COLO-START 

»YES *** 
• * * 
*> BO* 

* * 
*** 



ENTER EOB 

* 4 

*************** 



WARM-START 



*************** 



*************** 



If********** 



BLOCK 85 

FINISHED MT 

ENTRY A*., A7, 

A9, Bl. B4 



OUMPu/PURG * 



COLO-START 
*N0 *.** 



DUMPO OR *> BO* 
PURGE CKPT 7 ♦ * * 
« * *** 



* *YES *♦* 

* » * 
COLD START 7 *> CI* 



A9 



H9 



V COLD-START WARMSTART2 V 
tt**«*****»**** *************** 

k * *»* * * *** 

* * * * * * * 
k> BO* * MOUNI OLD LOO *> CO* 

* * * * TAPE • * * 
* *** * * *** 

i(fr«***t**« *************** 



ENTER BUILOJ 



Figure 7- Sequence of events for restart types (page 1 of 2) 
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» » ft 

»BT*> F.NTfiH F(Ji)'1M 
♦ • ALL 

• t 



*****4i******»** 



*************** 



• US'- NIVJIdL 



* *N'J 

ihsrAST ^p■-!'^ * 

4 CHECKPIlIi^T 
PMPiJ DK OU'^nt ♦ 

• IX Mil 7 • 



CI 
OLD-LOG 

*YFS **• 

*> B9* 

* • • 
* *** 



f'li'^-IOSS * 



e « 

EMTFK 

CHECKPOINT 

DAIb/Tr«F 

» « 



*************** 



********•«•*•*• 



* 

FMTFR 
/CiESTA^T 
CHECKPOINT 
DATE/THC • 



*************** 



*************** 

* * 

* BACK OUT * 

* PARTIALLY • 

* PROCESSED * 
♦TRANSACTIONS ♦ 



* NEW SECURI TV 



*************** 



*************** 



t*********** 



*************** 

* * 
ENTER 

PASSWORD OR 
TERMINAL 

* * 
*************** 



*************** 



ENTER FOB 

*************** 



ENTER EQB 

t * 

*************** 



*************** 
EXIT 



NO-SLOa V 

*************** 
«nUTPUT-MSG * 



*************** 



************** 



*************** 



I A9 

BUI L DO V 

*************** 

* ENTFR * *** 

• /FPFSTART * * * 
» SER- SERIAL *> B0» 

• NUMHLR. * * * 

♦ ...BilILOO • *** 
*************** 



************* 



*************** 



Figure 7. Sequence of events for restart types (page 2 of 2) 
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To show the relationships more closely and all the operands 
associated with each command, lists are noted with symbol numbers (A2 
through A7 , page 1 etc . ) . 

Example i 

In cold start with a previous simple checkpoint, follow symbols AO 
through A5, BO through B3, and B5 in Figure 7, page 1. This is the 
logical sequence in determining the complete command to enter. The 
sequences are numbered and entered in Figure 6 for reference. 

Sequence 1: Figure 7,, page 1, shows a cold start with simple 
checkpoint. Follow AO through A5, BO through B3, and B5 for the 
sequence of events for master terminal entry. Symbol BO means: Is the 
disk message queue allocation new? Has the space been used by another 
program? If the answer is yes (Bl) , enter FORMAT ALL to the restart 
command. This will pre format the disk message queues. 

Sequence 2: Figure 7, page 1, shows a warm start with a previous 
shutdown of checkpoint FREEZE. Follow AO through A8 and BO through B5 
for the sequence of events for master terminal entry. Symbol A6 means: 
If the input system log DD card specifies the proper log volume, the 
serial number of that checkpoint log tape need not be entered as the SER 
parameter to the master terminal. Symbols B3 and BU show that terminal 
and/or password security can be invoked at this time. 

Sequence 3: Figure 7„ page 1, shows a warm start with either checkpoint 
PURGE or checkpoint DUMPQ.. Follow AO through B5 for the sequence of 
events for master terminal entry. Symbols A8 and A9 deal with the PURGE 
and DUMPQ checkpoint, during which the BLDQ parameter should be entered 
to the restart command. This reconstructs the disk message queues from 
the specified checkpoint. 

Note that, with reference to Sequence 1, 2, and 3, after the entry of 
the command into the master terminal, symbols B6 through C3 continue. 

Emergency Restart 

To restart using emergency restart, again refer to Figures 6 and 7. 
The same assumptions stated in the normal restart section are valid. 

Sequence 4^: Figure 7 shows an emergency restart with a simple 
checkpoint. This emergency restart is performed because core was the 
only thing lost. Follow AO through A3, page 1, and AO and A2 through 
A6, page 2, for the sequence of events for master terminal entry. 
Symbol AU, page 2, shows that if the DD input card does not specify 
proper volume the serial number of that checkpoint log tape should be 
entered to the master terminal by the SER parameter. 

Sequence 5: Figure 7 shows an emergency restart with a previous 
checkpoint PURGE or DUMPQ. This type of emergency restart is wanted 
because of the loss of message queues. Follow AO through A3, page 1; 
AO, A2, and A9 on page 2; then, BO through B6. Bl question means: Is 
the checkpoint either DUMPQ or PURGE or is it a simple checkpoint? Yes 
means it is a DUMPQ or PURGE, so proceed to B2. Symbol A9 indicates 
that many tape log serial numbers may be entered. 

Note that, with reference to Sequences 4 and 5 after the entry of the 
command into the master terminal, symbols A7 through B6 on the second 
page of Figure 7 continue. 

Details of the restart commands are contained in Chapter 3 of this 
manual. If an emergency failure of a data base occurs, see "Data Base 
Maintenance and Failure" in this chapter. 
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STOPPING IMS/360 

There are four checkpoint commands which may be entered at the master 
terminal. The simple checkpoint command does not shut down IMS/360; it 
takes a "snapshot" of the status of the control program blocks and then 
continues . 

The three checkpoint commands which terminate all message regions and 
the IMS/360 control region are: 

1. /CHECKPOINT FREEZE Use this command if (1) IMS/360 must be 

terminated quickly, (2) the disk message 
queues will not be disturbed before 
restarting, or (3) the output messages can 
wait until later. 

2. /CHECKPOINT DUMPQ Use this command if (1) IMS/360 must be 

terminated, (2) the disk message queue space 
may be used before restarting or (3) the 
output messages can wait until later. 

3. /CHECKPOINT PURGE Use this command if (1) IMS/360 must be 

terminated, or (2) it is desired to process 
and send all messages currently in the 
system. 
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The sequence of events is; 



* EhlER « 

* MESSAGE '-f 
4 «* =!< f * * 4 * =!< * * ^' * * 



J 

V 

£ME« 
/CHECKPOINT 
PHEfcZt GK 
HLKCE OR 
' DUjMPQ 



*QCT,PCJ-HSG 

^ ^ :je 

:*ChKPT *NB8 
*TVPE *SbR 



=> CUl^PLETt 'i' 
*I^CRNAL CS/360* 

♦ SHLTDCk^N ♦ 

♦ ♦ 



If time permits, broadcast messages 
to all remote users that the system 
is being terminated. 



Select and enter into the master 
terminal one of the above checkpoint 
commands . 



A message comes back to the master 
terminal with the time and date, the 
type of checkpoint, and the serial 
number of the volume on which the 
checkpoint was written. This 
indicates that the checkpoint is 
complete and that IMS/360 is stopped. 



Complete normal Operating System/360 
shutdown procedures to terminate 
Operating System/3<60. 



After normal shutdown is complete, the IMS/360 log tape will rewind 
and unload. Dismount it, label it, and give it to the master terminal 
operator for logging and filing. 



A recommended procedure after each shutdown, whether normal or 
emergency, is to manually record the information in a form similar to 
that shown in Figure 8. This information will be used later for 
restarting the system. 
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DATE 



TYPE OF 
SHUTDOWN 



CHECKPOINT 
NUMBER 



VOLUME 
SERIAL 
NUMBER 
OF TAPE 



REASON FOR 
SHUTDOWN 



Figure 8. Example of IMS/360 manual shutdown log 



DATA BASE MAINTENANCE AND FAILURE 

At periodic intervals, a data base should be scheduled to be 
checkpointed, or a data base will be determined to have failed and a 
restart is needed to place the data base back on line. 

There is a checkpoint command called data base dump (DBDUMP) that 
handles a scheduled data base dump, and a DBDUMP with STOP that is used 
to stop all activity against a data base without a dump. The DBDUMP 
with STOP is used in preparation for data base recovery. 

Figure 9 shows the sequence of events for data base dump and for data 
base dump with STOP. Figure 10 shows the sequence of events for data 
base recovery. 
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*************** 

START DBDUHP 
*************** 



* » *SCHEDULE DUMP* 
•BO* — >*PGM INTO MSG * 

* ♦ * REGION * 
** * 4 

*************** 



*************** 

START DBDUHP 

STOP 

*************** 



END 
*************** 

END DBOUMP 

STOP 

*************** 



/^ 



V 



*************** 

t * 

ENTER 

/BROADCAST 

AND HSG 

* * 

*************** 



*************** 



*************** 

¥ * 

ENTER 

/BROADCAST 

HSG SAYS OB 

► STOPPED * 

*************** 



*************** 

» * 

ENTER /DBDUHP 

DATABASE 

NAME(S) 

» 4 

*************** 



*************** 

► ENTER * 
/BROADCAST 
MSG NORMAL 
OPERATIONS 

» AGAIN * 
*************** 



*************** 

» * 

ENTER /DBDUHP 

DATABASE 

NAHE(SI STOP 

» * 

*************** 



************* 



*************** 

END DBDUHP 
*************** 



*************** 



*************** 



END 

*•* 
* * * * 

* *DBDUMP * > 00* 

* COHPLETED * * * 

* * *** 
*************** 



I Figure 9. Sequence of events — DBDUMP and DBDUMP with STOP 

DATA BASE DUMP - NORMAL MAINTENANCE 

In Figure 9 , symbols AO through A4 and BO through B3 are the events 
for data base dump. 

Symbol Al of Figure 9 means that, when it is decided to do a data 
base dump from the master terminal, a broadcast message should be placed 
to notify the remote terminals that a certain data base is being dumped 
and is not to be used. Symbol A3 shows an output message that a data 
base dump is in progress, indicating that all activity against the data 
base(s) is stopped and a simple checkpoint is taken. Symbol A4 
indicates to the master terminal that a checkpoint is complete, that a 
current log is closed, and that a new log is opened to provide a clean 
starting point in case of a later data base recovery. 



DATA BASE DUMP WITH STOP FROM FAILURE 



In Figure 9, symbols CO through C4 and DO are the events of a data 
base dump with STOP. 

Symbol C3 of Figure 9 shows the output message to the master 
terminal, which means that all transactions that use the data base(s) 
are PSTOPed and that the data base(s) is also closed. Symbol CU 
notifies the master terminal that all data base activity is stopped. 



c 
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In order that the data base can be restored, the next sequence of 
events is concerned with the data base recovery command. 

DATA BASE RECOVERY FROM FAILURE 

The data base recovery command is used to rebuild or recreate a data 
base used for message processing. It is usually used for emergency 
failures of a data base. 

When a data base must be recreated, the DBDUMP command with the STOP 
operand, the DBRECOVERY command, and all system log tapes since the 
/DBDUMP are employed. 

Figure 10 shows the sequence of events for data base recovery. 



UBKECOVEXY 



♦***♦*♦♦*♦* 



>*«< 



/BRilADCASI 
"tSSAGE J1 
UNAVAILAJLfc « 
»»♦»»»**»»***» 



LNTTK /DbUUMP 

DATABASE 

NAMFiSI SlOf 

» 4 



»*»»«♦*♦»»«»»*» 



OUTl 
*OUTPUr-MSG 



»**»»«**«****» 



*************** 



t******** 



*************** 



**(,************ 



**v************ 



****#**^t******* 

» * 

ENTFR 

/OBRECOVcKY 

t>IAM[.(S) SER - 

► SFKl, ETC. * 

*************** 



HOKb TAPES ? 



nuTi 

************ 
♦OUTPUT-MSG 



*************** 



*************** 

t * 

EMTEk 

/BKHAnCAST 

NORMAL 

* OPEIUTIONS • 

*************** 



*************** 

= XIT 
*************** 



*** 
* * 
K C3* 



Figure 10. Sequence of events — DBRECOVERY 

In Figure 10, symbol A3 means that the latest backup copy of the data 
base should be used to reload it; this is done in an IMS/360 Type 3 
processing region (batch) environment. Symbol AU indicates the data 
base(s) to be recovered and the log tapes needed. The serial numbers 
must be in chronological sequence. The sequence starts with the first 
one after the backup copy was created with /DBDUMP command. 

Those log tapes that are used to restore the data base(s) include all 
those from the dump to the log tape mounted when this command is given. 
Symbol Bl shows a message returned to the master terminal. At this 
point, the current log tape is closed so that it may be used as input to 
the recovery program. A new log tape will be opened. This message is 
to the master terminal only. Symbol B3 means that the input messages 
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will be processed from the log tape as if they were from the terminals. 
Symbol CO means to start all transactions and notify the master terminal 
that normal operations may resiime. Symbol CI means that the master 
terminal should notify the remote terminals, by the BROADCAST command, 
that normal operations have been resumed. 

Note that the /DBRECOVERY command is a single-line command. If there 
are too many tapes for one line, the command must be reentered for the 
extra tapes after the first one is completed. If the serial number of 
the current log tape is not known, issue a /CHECKPOINT command. The 
checkpoint- completed message will contain the desired serial number. 



IMS/360 LOG TAPE 



In the section "Starting IMS/SeO" in this chapter, it is shown that a 
mount message is returned to the System/360 console. This is the 
message to mount the IMS/360 log tape. The mounting of a new log tape 
should be done without delay, as the whole system is in a wait state 
until the tape is mounted. 

It is recommended that all IMS/360 log tapes be filed and accounted 
for by the master terminal operator. The physical location of the 
master terminal and the computer console plays a part in this decision. 

With the assumption that the master terminal operator is responsible 
for the log tapes, the following steps should be considered by the 
Machine Operations function: 

1. Console Operator 

• As a result of an EOV (end of volume) or FEOV (forced end of 
volume) condition on the IMS/360 log tape, the old log tape 
is taken down and a new one is mounted. 



r 



Pull the write protect ring from the old log tape. 

Put a tape label on the old log tape and fill in the required 
information. 



Example of label: 



IMS/360 LOG TAPE 



Shutdown 



Density 



Begin Time 
End Time 

Date 



L J 



• Send the old IMS/360 log tape to the master terminal operator 
for logging and filing. 

2. Master Terminal Operator 

• All IMS/360 log tapes received should be checked before 
filing to make sure the label is filled out properly. 



9U 



Record the information from the log tape label in a manual 
record. Figure 11 is an example of a manual record. 

Set a release date for all old log tapes. Monitor these 
dates, keeping in mind that data base dumps have an effect on 
when log tapes can be released. 



DATE 



CHECKPOINT 
NUMBER 



VOLUME 
SERIAL NO. 



REEL NO. 



Figure 11. Record of IMS/360 log tapes 
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CHAPTER 6. EXECUTION OF IMS/360 UTILITY PROGRAMS 



These are the IMS/360 utilities which the Machine Operations function 
will have to process from time to time: 

• IMS/360 System Log Utility Program (to produce statistical reports) 

• Data Base Description Generation (DBDGEN) 

• Program Specification Block Generation (PSBGEN) 

• Security Maintenance Program 

• IMS/360 System Definition 

IMS/360 STATISTICS REPORTS 

The IMS/360 Statistics reports can be run by date or by a time period 
greater than a day. The time for running the reports can be agreed upon 
between Systems Operation and Machine Operations functions. 

Statistics reports are run from the IMS/360 system log tape(s) as a 
standard Operating System/360 batch job. The system log utility program 
provides all of the reports: 

• Messages Queued But Not Sent Report — by terminal 

• Line and Terminal Report / 

• Error Report 

• Messages Queued But Not Sent Report — by transaction code 

• Transaction Report 

• Transaction Response Report 

• Application Accounting Report 

• IMS/360 Accounting Report 

• Operating Information Report — can be varied by various control 
cards (sort fields) 

This utility program has two edit passes and two sorts before the 
reports are produced. 

The Systems Operation function must provide the complete card deck 
for this utility including the JCL. For more details see the section 
"IMS/360 System. Log Utility Program" in Chapter 6 of the IMS/360 
Operations Manual, Volume I -• Systems Operation . 

DATA BASE DESCRIPTION GENERATION (DBDGEN) 



DBDGEN must be run as a normal Operating System/360 job after IMS/360 
system definition. IMS/360 system definition causes the DBDGEN 
procedure to be placed in the user's specified procedure library. To 
process a request for a DBDGEN, Machine Operations must assume that the 
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DBD generation control cards are provided. Using the procedure DBDGEN, 
the JCL cards are: 



//DBDGEN JOB MSGLEVEL=1 
// EXEC DBDGEN, MBR= 
//C . SYSIN DD * 

DBD 
OMAN 
SEGM 

FIiDK [ DBD generation control cards 

FLD 

DBDGEN 
FINISH 
END 
/* 



where keyword operand MBR= is the name of the DBD to be generated. 

More details about DBDGEN are found in the IMS/360 Program 
Description Manual and the Systems Operation Manual . 



PROGRAM SPECIFICATION BLOCK GENERATION (PSBGEN) 

PSBGEN is run as a normal Operating System/360 job after IMS/360 
system definition. IMS/360 system definition causes the PSBGEN 
procedure to be placed in the user's specified procedure library. To 
process a request for a PSBGEN, Machine Operations must assume that the 
PSB generation control cards are provided. The following JCL cards are 
used to invoke the PSBGEN procedure. 

//PSBGEN JOB MSGLEVEL=1 

// EXEC PSBGEN, MBR= 

//C. SYSIN DD * 



PCB j 

SENSEG I The control cards for PSB generation 

PSBGEN ( 

END J 

/* 

where keyword operand MBR= is the name of the PSB to be generated. 

More details about PSBGEN are found in the IMS/360 Program 
Description Manual and the Systems Operation Manual. 



SECURITY MAINTENANCE PROGRAM 

Before a request can be processed for new security for IMS/360 using 
the IMS/360 Security Maintenance Program, see the Systems Operation 
function for the allocation of certain data sets. 

Make sure that the input statements are provided. Then this JCL can 
be used to process the Security Maintenance Program using a procedure, 
SECURITY, supplied through IMS/360 system definition: 
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//JOBNZ^ME JOB 1,SMP,MSGLEVEI.=1 
//STEP EXEC SECURITY 
//S.SYSIN DD * 

I Input statements I 

/* 

The following keywords may be used on the EXEC card for the supplied 
SECURITY procedure: 

OPTN = r update ] , 
L LIST J 

where : 

update replaces existing security tables. 

LIST edits and verifies input statements. 

IMS = 



r 1.01 -| , 

I • , number* J 



where : 
number 



where : 
class 



represents the suffix character of the IMS/360 control 
program member name in IMS.RESLIB (that is, DFSINUCO or 
DFSINUCn) . The reader should reference the IMSTEST 
macro-instruction in the IMS/360 Systems Operation 
Manual. 

SOUT = r A ] , 
[class J 



represents the SYSOUT class for message data sets used 
in security maintenance. 



The procedure supplied by IMS/160 system definition is found in 
Chapter 3 of the IMS/360 Systems Operation Manual. 

IMS/360 SYSTEM DEFINITION 

System definition is the process of defining or redefining the 
IMS/360 system for a given user's data processing environment. It is 
similar to Operating System/360 system generation. IMS/360 system 
definition is a two-stage operation. It is recommended that a member of 
Systems Operation be present when this utility is run. Systems 
Operation should provide the Stage 1 input control cards. 

The Job Control Language (JCL) for Stage 1 of system definition is 
for an assembly execution. Use of the standard Operating System/360 
Assembler procedure (ASMFC) with the following SYSLIB DD card override 
is possible. The user generates a card deck of the following format and 
places these cards in the job stream. 
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// JOB 

// EXEC ASMFC 

//ASM.SYSLIB DD DSN7^E=IMS .GENLIB, DISP=OLD 

//ASM. SYS IN DD * 



IMS/360 Stage 1 - 
INPUT CONTROL CARDS - 
[ SYSTEM DEFINITION PROGRAM 



/* 

The result of system definition Stage 1 is the construction of a JCL 
stream card deck. This card deck becomes input to the system definition 
Stage 2. The JCL supplied by the user generating the system for Stage 2 
is only a JOB card, which is placed in front of the punched card deck 
received from Stage 1. Place this deck of cards in the job stream. 

An example of system definition is shown in Chapter U of the IMS/360 
Systems Operation Manual . 
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CHAPTER 7. MESSAGES AND CODES 



USER ABEND CODES 



Comp, 
Code 

OOOU 



Issuing 
Component. 

DFSIRCOO 



0008 



DFSIRCOO 



0016 



DFSIRCOO 



0024 



DFSIRCOO 






0032 



DFSIRAOO 



0036 



0040 



OOUU 



OOUS 



0052 



DFSIRAOO 



DFSIRAOO 



DFSIRAOO 



DFSIRAOO 



DFSIRAOO 



Explanation 

An attempt was made to initiate an 
IMS/360 Type 1 or Type 2 processing 
region when the IMS/360 control program 
(Region Type 0) was not active in the 
Operating System. 

System error. While attempting to 
initiate a message processing region or a 
Type 2 batch region, the IMS/360 region 
control program passed an invalid event 
control block address to the IMS/360 
interregion communication SVC's. 

The IMS/360 region control program was 
unable to complete initiation of a Type 1 
or a Type 2 processing region. The 
addition of another region to the number 
then executing would have exceeded the 
value specified in the MAXTASK operand of 
the IMSCTRL macro-instruction at IMS/360 
system definition time. 

System error during initiation cycle of 
region controller. A message or Type 2 
batch region has been activated 
asynchronously because of an error in the 
IMS/360 control program (Type region) . 

PARM field was omitted from the EXEC 
statement. PARM field controls type of 
execution. (See Chapter U of the IMS/360 
Systems Operation Manual for 
explanation.) 

Program (PSB) name was omitted from the 
PARM field on the EXEC statement of an 
IMS/360 Type 2 or 3 region (batch). 

PARM field of EXEC card is invalid format 
for Type 2 or 3 IMS/360 region. Comma 
does not follow first positional 
parameter. 

PARM field of EXEC card specifies an 
invalid region- type code. 

PARM field of the EXEC card contains an 
excessive number of positional 
parameters. 

First character of a positional parameter 
in PARM field of the EXEC card is blank 
or invalid. 
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0056 



DFSIRAOO 



A positional parameter in the PARM field 
of the EXEC card exceeds maximum 
allowable length. 



0060 



DFSIRAOO 



A required positional parameter is 
omitted from the PARM field of the EXEC 
card. 



006U 

0068 
0072 

0076 
0150 



DFSIRCOO 



DFSIRAOO 



DFSIRAOO 



DFSIRAOO 



DFSIDBAO 



0151 



DFSIDBAO 



0200 



DFSIDLKO 



0201 



0202 



DFSIDLKO 



DFSIDLKO 



0203 



DFSIDLKO 



Dispatching priority of a message 
partition running in an MFT-II 
environment is higher than that of the 
IMS/360 control program (Type region) . 

Invalid second character in Type PARM 
field. Value must be zero or one. 

Issued following the message IMSIOOI, the 
IMS/360 control region Type was not 
executed because another Type region 
was currently active in the same system. 

Operator replied CANCEL to the message 
IMS050D. 

PCB address passed in the USING list of a 
Type 3 batch program is not the same as 
any passed to the program by IMS/360 at 
first entry. The PCB referred to in the 
CALL statement may not have been defined 
at PSBGEN time. The USING list of the 
CALL statement may be improperly 
constructed. 

USING list of CALL Statements in a Type 3 
batch program is truncated at the 
function position. There is no PCB 
address in the call. Call list has only 
one entry. 

The available dynamic main storage in the 
Operating System/360 region or partition 
in which a Type 1, 2, or 3 region is 
operating is not sufficient to allow the 
Data Language/I block loader to fetch the 
required PSB*s and DBD's. Increase 
region size. 

PSB loaded in the application program 
processing region has invalid or 
inconsistent processing options 
specified. Check PSB generation. 

The data bases named at PSBGEN do not 
agree with those specified for the same 
PSB name at IMS/360 online system 
definition. Check IMS/360 online Stage 1 
DMB directories and PSB generation. 

The first defined segment in DBD is not a 
root segment. Register 2 points to the 
DBD. Add 8 to contents of register 10. 
This points to the segment name in 
question. Check DBD generation. 
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0204 



DFSIDLKO 



0206 



0208 



DFSIDLKO 



DFSIDLKO 



Error in implied hierarchical definition 
of sensitive segments in PSB. Register 
10 points to segment name at which error 
was discovered. Check both DBD and PSB 
generation for conflicting definitions. 

Unable to open PSB and DBD libraries. 
Check proper allocation for DD name 
IMS/360 in JCL for Type 1, 2, or 3 
region. 

A sensitive segment is named in PSBGEN 
for which no corresponding segment name 
was defined in the associated DBDGEN. 
Register 3 at ABEND points to the 
unmatched sensitive segment name. 
Register 9 points to the DBD name. 
Register 8 points to the data base PCB 
name in the PSB. Check PSBGEN and 
DBDGEN. 



0209 



DFSIDLKO 



0210 



DFSIDLKO 



0211 



DFSIDLKO 



0212 



0213 



DFSIDLKO 



DFSIDLKO 



DBD specifies an unsupported or unknown 
access method. Register 8 or register 4 
points to the DBD name. An offset of 8 
from the address pointed to by register 
11 is the specific DCB within the DBD 
that is in error. Check DBD generation. 

System error. DBD does not contain a DCB 
type required to construct the DMB. DCB 
type required is pointed to by register 
3. An offset of 12 from register 2 
points to the first DCBTAB in the group 
of DCB's examined. 

System error. SDB (SEGM) is followed by 
more than one key (FLDK) definition. 
Register 11 points to FLDTAB, register 6 
to SDB, and register 7 to FDB in error. 
Register 2 points to DBD. 

System error. The first FDB is not the 
key FDB (FLDK) definition, yet physical 
codes for field and SDB are equal. 
Register contents same as 0211. 

System error. SDB has no key field 
defined. SEGM statement not followed by 
FLDK or FLD Statement. Register contents 
same as for 0211. 



0225 



0228 



DFSIBDRO 



DFSIBDPO 



Error return code on write to master 
terminal. Will appear as a message 
region ABEND on the master terminal. 

Cannot find the master terminal CNT, 
Will appear as a message region ABEND on 
the master terminal. 



0229 



02U0 



DFSIBDPO 



DFSIPCOO 



Cannot find key field for a segment in 
the DBD. Will appear as a message region 
ABEND on the master terminal. 

Message processing application exceeded 
allowable execution time in a Type 1 
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message region. See Chapter U of the 
IMS/360 Systems Operation Manual under 
the heading "TRANSACT Macro" for a 
further explanation. 



0260 



DFSIPROO 



Number of parameters (data items named in 
USING list) in the application program 
CALL exceeds the allowable limit. 



0261 



DFSIPROO 



0301 



0302 



DFSICLIO 



DFSICLIO 



0303 


DFSICLIO 


0305 


DFSICLMO 


03.0_6^ 


DFSICLMO 


^^3//--' 




ouou 


DFSIPROO 



0408 



DFSIPROO 



One of the values passed in the USING 
list of the application program Data 
Language/I CALL is invalid. It either 
exceeds object machine size, does not 
meet alignment requirements, or violates 
storage protection boundaries. 

System error. CLBSTATS vector contained 
an invalid value entry to input 
processor. 

Unidentifiable terminal address while 
searching for input CTB. System error; 
polling list probably no good. 

System error. Illegal return to input 
processor from message generator. 

System error. Invalid return code from 
ICREATE buffer request. 

System error. Invalid return code from 
IWRITEQ buffer request. 

During execution of a Type 1 message 
processing program or a Type 2 batch 
program, the IMS/360 control program 
(Type region) terminated abnormally. 

During execution of a message processing 
application or a Type 2 batch program, an 
invalid event control block address was 
passed to the IMS/360 interregion 
communication SVC. 



0424 



DFSIPROO 



0U28 



DSFIASOO 



System error. A message or Type 2 batch 
region has been activated asynchronously 
because of an error in the IMS/360 
control program (Type region) . System 
error during the application program 
communication cycle of the program 
request handler. 

A Type 2 batch step could not be 
initiated because the program named in 
the second positional operand of the PARM 
field was not defined at system 
definition time. 



0U32 



DFSIASOO 



A Type 2 batch step could not be 
initiated because the program named in 
the second positional operand of the PARM 
field was not defined as a Type 2 program 
at system definition time. 
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0436 



DFSIASOO 



A Type 2 batch step could not be 
initiated because the input symbolic 
queue named in the fourth positional 
operand of the PARM field was not defined 
at system definition time. Check PARM 
field to ensure that input symbolic naime 
is correct. 



OUUO 



DFSIASOO 



A Type 2 batch step could not be 
initiated because the input symbolic 
queue named in the fourth positional 
operand of the PARM field was a logical 
terminal name. It may be only a 
transaction code. 



0UU4 



DFSIASOO 



A Type 2 batch step could not be 
initiated because the output symbolic 
queue named in the fifth positional 
operand of the PARM field was not defined 
at system definition time. Check PARM 
field to ensure that output symbolic name 
is correct. 



0UU8 



DFSIASOO 



A Type 2 batch step could not be 
initiated because the input transaction 
code named in the fourth positional 
operand of the PARM field had a nonzero 
limit, normal, or current priority. All 
priorities for a transaction code to be 
used as input by a Type 2 batch program 
must be zero. 



0452 



DFSIASOO 



0456 



DFSIASOO 



0460 



DFSIASEO 



A Type 2 batch step could not be 
initiated because the transaction named 
in the fourth positional operand of the 
PARM field has been stopped or locked by 
a command or by a prior program failure. 

A Type 2 batch step could not be 
initiated because the program named in 
the second positional operand of the PARM 
field has been stopped or locked by a 
command or by a prior program failure. 

During an attempt to complete scheduling 
of a Type 2 batch region, the Type 
control region was unable to communicate 
with the Type 2 region which requested 
scheduling. Possible reasons are that 
the Type 2 region job was canceled by the 
system console operator; was canceled by 
job step timer expiration; was canceled 
for exceeding specified queue space; or 
was canceled for exceeding wait-time 
limitations. 



This completion code will appear on the 
IMS/360 master terminal in message number 
IMS901I. 



0464 



DFSIASEO 



During scheduling of a Type 1 message 
processing region by module DFSIASIO, the 
Type region was unable to communicate 
with the Type 1 region. See 0460 for an 
explanation of possible reasons. A 



( 
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0U68 



DFSIASEO 



0U72 



DFSIASEO 



0U76 



0501 



DFSIDLAO 



DFSICLOO 



message processing region should be 
stopped only through the use of the 
IMS/3 60/STOP REGION command. 

After processing a DL/I call for a Type 1 
or a Type 2 region, the DL/I analyzer, 
DFSIDLAO, was unable to communicate with 
the caller's region. See 0460 for an 
explanation of possible reasons. 

During termination processing by module 
DFSIASTO, the Type region was unable to 
communicate with a Type 1 or Type 2 
region. See 0460 for an explanation of 
possible reasons. 

A Type 1 or 2 processing application 
provided an invalid .PCB address in a Data 



Language/I call. V- 



^ 



r^-^ 






System error. CLBSTATS vector contained 
an invalid value upon entry to output 
processor. 



lOU.l 



104.2 



0502 



DFSICLOO 



System error. RWQO was unable to 
complete a read request for first buffer 
or segment. Register U at ABEND contains 
the return code from RWQO. 



0503 
050U 
0505 
0701 

0702 

0703 
0704 

0705 
0706 

0707 
0708 
0709 



DFSICLOO 
DFSICLAO 
DFSICLPO 
DFSIIDEO 

DFSIIDEO 

DFSIIENO 
DFSISMNO 

DFSISMNO 
DFSISMNO 

DFSISMNO 
DFSISMNO 
DFSISMNO 



0710 



DFSIOS60 



System error while core enqueuing or 
dequeuing a CNT in the output processor. 

Read or write queuing error. Return code 
from RWQO in register 2 at ABEND. 



System error. 
DFSICLDO. 



Invalid entry number from 



0711 



DFSIDLMO 



System error. Invalid control blocks 
passed. Unable to determine whether QE 
or QCB. 

System error. Attempted to dequeue a QE 
which indicated no optional backward 
pointer slot available. Must be present 
if called with only a QE pointer. 

System error. Attempted to enqueue using 
either an invalid QCB or QE. 

System error. Attempted to ICREATE using 
a pool name which already exists. 
Duplicate pool error. 

System error. Attempted to IDESTROY 
using a pool name which does not exist. 

System error. While attempting to 
IDESTROY using a valid pool name, the 
zone end block has been altered. 

System error. Attempted to get buffer 
(GETBUF) using a nonexistent pool name. 
Register 2 at ABEND contains the 
erroneous pool name. 

System error. Attempted to free a buffer 
(FREEBUF) using a nonexistent pool name. 
Register 2 at ABEND contains the 
erroneous pool name. 

System error. Attempted to get a buffer 
(GETBUF) which exceeded the total length 
of a variable-length pool. Register 2 at 
ABEND contains the pool name. Register 3 
contains the requested size. 

During OPEN of a Data Language/I overflow 
data set, the calculated block length 
exceeded the maximum track length for the 
device allocated. Check DD cards for 
0S2\M data set allocation. Register 3 
points to the Data Control Block (DCB) at 
ABEND time. 

System error. Attempted to acquire pool 
space for a DMB whose name could not be 
found in the list of DMB directories 
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0712 



DFSIDLMO 



pointed to by the scheduled PSB directory 
entry. 

System error. Attempted to move a DMB 
whose name could not be found (see 0711). 



0713 



DFSIASOO 



0715 



DFSIINTO 



Unable to schedule an application program 
because insufficient data base buffer 
space available. Check TP and OSAM 
buffer pool size specified in the PARM 
field of the Type EXEC statement. 

During initialization of the IMS/360 
control program, one of the following 
errors occurred which relate to DBD's 
known to the system: 

1* No allocation was made for DBDLIB in 
the IMS/360 Type job step. 

2. An I/O error occurred while reading 
the DBDLIB PSB directory. 

3 . None of the defined DBD names could 
be found on the data sets allocated 
for DBDLIB. 



See messages numbered 

IMS102I 
IMS103I 
IMSlOm 
IMS105I 
IMS106I 

for further information. 



0716 
0717 



DFSIINTO 



DFSIINTO 



0718 



DFSIINTO 



0719 



0720 



DFSIINBO 



DFSIDLMO 



System error. Initialization table NTBO 
contains invalid transfer vectors. 

An error occurred during attempt to 
establish pool sizes as specified or 
implied by the PARM field of the IMS/360 
Type region EXEC card. Check JCL, 
partition/region sizes, etc. 

An error occurred during IMS/360 
initialization. Either a required load 
member could not be found or a permanent 
I/O error was encountered while searching 
library directories. See messages 
IMS112I, IMS113I, and IMSllUI. One of 
these messages will appear on the 
Operating System/360 operator's console 
printout . 

Type initialization was unable to 
successfully open any line groups. See 
message IMS115I for further explanation. 

The DMB pool is too small to hold the 
required DMB's, or the PSB pool is too 
small to hold the PSB. Change the PARM 
value for PSB pool size or the DMB pool 
size in the Type region EXEC card. 
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0721 



0750 



0751 



DFSIDLMO 



DFSIISMO 



DFSIISMO 



The IMS/360 dequeue module (DFSIIDEO) 
encountered an error while attempting to 
dequeue a PSB from the SCDPSBMU QCB. 

System error. While processing a call 
for a message processing or Type 2 batch 
region, ISAM record read was of greater 
length than buffer allocated. 

System error. SYNAD routine entered 
after a SETL, but synchronous error 
routine did not return a known SETL error 
code. 



0752 



DFSIISMO 



A SETL returned a not found, so a second 
SETL for what was found was issued. This 
also returned a not found, which should 
not happen. Data base was probably not 
completely loaded or DD cards for the 
ISAM data set have RECFM=F. 



0753 



DFSIISMO 



System error. SYNAD routine entered 
after a GET, but synchronous error 
routine did not return a known GET error 
code. 



0754 



DFSIISMO 



System error. SYNAD routine entered 
after an unknown operation, that is, not 
a GET or SETL. 



0755 

0756 
0757 



DFSIISMO 



DFSIRSTO 



DFSIRWQO 



System error. Unable to obtain an lOB 
from the BISAM read queue of lOB's while 
preparing for an update write. 



Unable to open input log file. 
IMSLOG and IMSLOGR DD cards. 



Check 



Queue data set overflowed. (Too few 
shutdown buffer records to handle 
shutdown, or shutdown delayed by Data 
Base Recovery.) Register 7 indicates the 
queue data set which caused the ABEND: 



0758 



DFSIRWQO 



Input QCR 
Input Msg 
Output QCR 
Output Msg 



Restart with a build queue 

Queue data set overflowed after reuse 
routine was unable to provide a record. 
Register 7 indicates the queue data set 
which overflowed (see 0757 User ABEND) - 
Register 6 indicates the reason that the 
reuse routine ceased: 



4 - No reusable records available 
8 - Nonhardware-caused I/O 

error 
C - I/O error count exceeded 



0759 



DFSIRWQO 



Unrecoverable I/O error. Register 5 
points to the OSAM DECB in error. The 
status bytes in the DECB will indicate 
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one or more of the following error 
conditions : 



Invalid request 

Unable to convert relative 

block number to actual disk 

address 

End of data set reached 

DCB not open 

New extent just obtained 

Data set not preformatted 

Space not found to add a 

block 



0800 



DFSIDLRO 



QISAM I/O error or IMS/360 system error. 
Register 9 contains JCBIND2, JCBIND3, 
JCBIND4, and JCBIND5. See the IMS/360 
System Manual, Volume I, for a 
description. 



0804 



DFSIDLDO 



QISAM I/O error or IMS/360 system error. 
Register 9 contains JCBIND2, JCBIND3, 
JCBIND4, and JCBIND5. See the IMS/360 
System Manual, Volume I, for an 
explanation. 



0808 


DFSIDLHO 


0809 


DFSIDLHO 


0810 


DFSIDLHO 


0815 


DFSIDLIO 


0820 


DFSIDLAO 



0825 



0901 



0902 



0903 



0904 



DFSIDBLO 



DFSISMPO 



DFSISMPO 



DFSISMPO 



DFSISMPO 



Operating System error while back-spacing 
HSAM file. JCB address is in register 8. 

During read backward, relative block 
number decreased to less than 1. JCB 
address is in register 8. 

Buffer space not available. 

Same as 0800, but in module DFSIDLRO. 

Invalid return code detected from IREADQ, 
IWRITEQ, or the Router. 

Space not available in data base buffer 
pool to perform data base logging as 
requested. Verify SSI value for DBD load 
module not altered since DBD generation. 

Error in security maintenance parameter 
field. See the IMS/360 Systems Operation 
Manual for format required. 

JOBLIB does not contain the SDB specified 
by the parameter field. 

DD required by SMP was not supplied. 
Register 2 points to the DD name of card 
required . 

SSI set on DFSISDBO is invalid or 
nonexistent. This SSI is set by system 
definition and is required to 
validity-check the system having security 
generated for it. 
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SYSTEM ABEND CODES 



Comp. Issuing 

Code Component Explanation 



FFE DSPO Completion code if ABEND dump at 

termination is requested in a checkpoint 
termination command. 



108.1 



108.2 



CONSOLE AND MASTER TERMINAL MESSAGES 



MSGNUMB 



IMS050D 



COMP 



RAOO 



IMS051I 



RAOO 



IMS052I 



RAOO 



IMSIOOI 



RAOO 



IMSIOII 



INDO 



IMS102I 



INTO 



MESSAGE AND EXPLANATION 

JJJJJJJJ.SSSSSSSS.PPPPPPPP CTL PGM NOT 
PRESENT REPLY 'WAIT' OR 'CANCEL* 

Explanat:ion ; If a Type 1 message or Type 2 
batch region is initiated prior to the Type 
region, the above message is issued. 

JJJJJJJJ - job name 

SSSSSSSS - step name, if any 

PPPPPPPP - procedure step name, if any 

jobname.stepname.procstepname WAITING TO 
INITIATE 

Explanation ; If the operator replies WAIT to 
message IMS050D, the job will attempt to 
locate the Type region eveiY 30 seconds 
until it is found. Each unsuccessful attempt 
will result in the above message at the 
system console. 

jobname.stepname.procstepname JOB CANCELLED 
BY OPERATOR 

Explanation : If the operator replies CANCEL 
to message IMS050D, the job step will be 
terminated abnormally with a user completion 
code of 0076, ^nd the above message will be 
displayed at the system console. 

jobname.stepname.procstepname CTL PGM NOT 
EXECUTED 

Explanation ; This message is issued to the 
system console when an attempt is made to 
initiate the second copy of a Type region. 

NO DATA BASE DIRECTORIES DEFINED 

Explanation ; At system definition time, no 
data bases were defined to the system. 
Therefore, no data base directory 
initialization is required. 

Action ; None required. 

NO ALLOCATION FOR DDN "IMS' 

Explanation ; To initialize IMS/360, the 
IMS/360 control program must have allocation 
for PSBLIB and DBDLIB. 

Action; See the IMS/360 Systems Operation 
Manual for further information on JCL 
requirements for a Type region. 
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IMS103I 



INDO 



UNABLE TO SUCCESSFULLY OPEN DDN 'IMS* 



Explanation ; A permanent I/O error may have 
occurred during OPEN. 

Action: Ensure that DD name IMS is allocated 
properly and that the data sets specified at 
IMS/360 system definition time or PSBLIB and 
DBDLIB exist. 



IMSlOm 



INDO 



PDS DIRECTORY READ ERROR DDN 'IMS' 



Explanation : An I/O error has occurred while 
trying to read the PDS directory for DD name 
•IMS' (PSBLIB and DBDLIB). 



IMS105I 



INDO 



Action: Check JCL to ensure proper 
allocation per Chapter U of the IMS/360 
Systems Operation Manual . 

BLDL FAILED FOR ALL DEFINED DATA BASE 
DIRECTORIES 



IMS106I 



INDO 



Explanation ; None of the data base 
definitions (DBD's) for data bases which were 
named at IMS/360 system definition time could 
be found on the data sets allocated to DD 
name IMS. 

Action : Check JCL for proper allocation. 
Ensure that at least one DBDGEN for the 
defined system has been run. 

BLDL FAILED FOR FOLLOWING DBD'S 

Explanation : DBD names are listed which 
could not be found or did not meet 
recpiirements on DBDLIB. A reason follows 
each name. 



DBDNAME • NOFND 
• DIRNG 



NOBUF 



• ALIAS 

• CNCAT 



Not found 
Directory 
entry incom- 
plete 
Directory 
entry correct 
size but 
buffer size 
was zero 
Alias names 
not allowed 
DBD was found 
in PSBLIB 
portion of 
concatenated 
data sets 



Action; None. Note, however, that no 
programs or transactions which use the named 
data bases will be scheduled for execution by 
IMS/360. 
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IMS109A 



INTO 



LAST IMS NUCLEUS TERMINATED ABNORMALLY 



Explanat.ion ; Either the last execution 
IMS/360 control program nucleus (Type 
region) terminated with a system completion 
code or it was canceled by the operator, step 
time expiration, etc. 

Action: As indicated by message. 



IMSlllI 



INTO 



WARNING... DEFINED AND ACTUAL PROGRAMMING 
SYSTEMS DIFFER 



IMS112I 



INLO 



Explanation ; At IMS/360 system definition, 
the programming system under which IMS is to 
run is specified as MFT or MVT. The 
programming system has no effect upon the 
Type region. However, it does determine 
which of certain IMS/360 routines are to be 
included in the OS/360 nucleus. 

Action: Notify system programmers 
responsible for IMS/360. 

PERMANENT I/O ERROR ON JOBLIB/LINKLIB 



IMS113I 



INLO 



Explanation : While searching the PDS 
directories for JOBLIB and SYSl.LINKLIB, a 
permanent I/O error occurred. 

Action: Ensure that JOBLIB allocation for 
Type region is correct. If it is correct^ 
seek assistance from the installation systems 
programming staff. 

BLDL FAILED FOR FOLLOWING JOBLIB/LINKLIB 



IMSllUI 



INBO 



IMS115I 



INBO 



Explanation : While searching the PDS 
directories for JOBLIB and SYSl.LINKLIB, 
modules required to support IMS/360 coiild not 
be found. Module names follow message. 

Action : Notify systems programmer 
responsible for IMS/360. 

LINE GROUP NOT ALLOCATED, DDNAME - XXXXXXXX 

Explanation : The line group of DDNAME 
XXXXXXXX is defined to the IMS/360 control 
program, but there was no DD card provided in 
the Type region JCL. 

Action: The DDNAME referenced may be a line 
group which was defined for expansion 
purposes, or it could be a JCL omission. If 
allocation for all line groups is omitted, 
this message will be followed by IMS115I. 

UNABLE TO OPEN LINEGROUPS 



Explanation : During initialization of the 
Type control region, it was not possible to 
open any communication line groups. The 
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IMS116I 



ASTO 



IMS117I 



ASTO 



IMS118I 



ASTO 



reason may be improper allocation or lack of 
allocation for any line groups. 

Action: Ensure that line groups are 
allocated using correct DDNAMEs as shown in 
output from Stage 2 of IMS/360 system 
definition. 

XX... X PROCESSING REGION STARTED 

Explanation : Indicates that a dependent 
processing region has started. XX... X may 
be: 

MESSAGE - Type 1 region 

BATCH - Type 2 region 

USER - Undefined direct interface 

/ 
Action: None. Information message. 

XX... X PROCESSING REGION STOPPED 

Explanation ; Indicates that a dependent 
processing region has stopped. XX... X may 
be: 

MESSAGE - Type 1 region 

BATCH - Type 2 region 

USER - Undefined direct interface 

Action: None. Information message. 

JJJJJJJJ.SSSSSSSS UNKNOWN CALL FUNCTION 
• FFFF * 

Explanation : The IMS/360 control program has 
received a request to schedule a program in a 
dependent region. The type of request cannot 
be identified. 



JJJJJJJJ - Jobname of requesting 

region 
SSSSSSSS - Step name of 

requesting region 
FFFF - Call function code 



IMS551I 



INTO 



Action: Notify the system programmer 
responsible for IMS/360. 

UNABLE TO OUTPUT TO MASTER TERMINAL 

Explanation : There have been uncorrectable 
I/O errors while attempting to output to the 
master terminal. 

Action: Either restart the master terminal 
at its present location or reassign it to 
another physical terminal. 
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IMS901I ASOO JJJJJJJJ KK SSSSSSSS PPPPPPPP (X) tTTTTTTT 

SYS, USER SMB PSB 

Explanation : Message number. 

JJJJJJJJ Input logical terininal name if 
X=l and name is available; if 
X=2, job name. If X=0 or 
terminal name is not available, 
JJJJJJJJ will appear in lowercase 
letters as "not avail" unless the 
master terminal device does not 
have lowercase capability. 

KK Protection key of abending 
region/partition. 

SSSSSSSS Operating System/360 step name of 
region or partition 

PPPPPPPP PSB or program name. 

X lf=0, IMS/360 region control 
program ABENDed 

If=l, Message processing program 
ABENDed 

If =2, Type 2 batch program 
ABENDed 

TTTTTTTT Transaction code 

SYS System completion code 

USER User completion code 

SMB If this appears, transaction code 
at TTTTTTTT was stopped. 

PSB If this appears, program named at 
PPPPPPPP was stopped. 

Action: Notify persons responsible for 
program and/or transaction code. Restart 
program unless persistent ABENDS indicate 
that problem is not isolated to stopped 
transaction code. 
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Terminal, List 12 
Comments 16, 70 
Communication Facility, Data 10 
Communication Terminals, 1050, 2260, 2740 10 
Console Messages, Master Terminal 109 
Console Operator, Computer 15, 75, 94 
Correction of Master Terminal Commands 1 6 
Correction of Remote Terminal Commands 54 

DATABASE 17,55 
DataBase 9 

Concepts, Application Data Integration 9 

Description Generation (DBDGEN) 96 

Dump - Normal Maintenance 92 

Dump with Stop from Failiure 92 

Log and No Log Commands 12, 52 

Maintenance and Failure 91 

Recovery Command 1 2 , 9 3 

Recovery from Failure 91 
Data Communication Facility 10 
Data Integration, Application, Data Base Concepts 9 
Data Language/I 9 

DBDGEN, Data Base Description Generation 96 
DBDUMP Command 12,46 

DBDUMP, DBDUMP with STOP, Sequence of Events 92 
DBLOG Command 12,52 
DBNOLOG Command 12,52 
DBRECOVERY, Sequence of Events 93 
Definition, System 98 



Definitions, Keyword, Remote Terminal Command 54 

DELETE Command 12,29 

Dialup, Switched, Terminal Startup 70 

DISPLAY Command 12, 11, 31 

Display Station, 2260 10, 11,63, 71, 68, 69 

Dump, Data Base, Normal Maintenance 92 

Emergency Restart 88 
END Command 11,12,63 
ERESTART Command 12,49,88 
Examples of Commands, Master Terminal 

ASSIGN 29 

CHANGE 27 

CHECKPOINT 46 

Data Base Dump 47,92 

Data Base Log 52 

Data Base No Log 52 

Data Base Recovery 52, 93 

DELETE 30 

DISPLAY 33 

ERESTART 50,88 

NRESTART 42,85 

PURGE 26 

START and STOP 21 

STOP 25 
Examples of Commands, Remote Terminal 

BROADCAST 61 

CANCEL 65 

END 64 

EXCLUSIVE 63 

lAM 68 

LOCK 58 

LOG 64 

RDISPLAY 67 

RESET 66 

SET 65 

TEST 62 

UNLOCK 58 
Examples of Manual Shutdown Log 9 1 
EXCLUSIVE Command 10, 11, 63 
Execution of Utility Programs 96 

Facilities, Checkpoint and Restart 10 
Facility, Data Communication 10 
Failures 

Data Base Dump with Stop from 92 

Maintenance, Data Base 91 

Recovery from , Data Base 93 

Remote Terminal, Reported, Log 72 
Formats 

Command Message 16,68 

Input, Terminal 15 

Message Switching 15, 69 

Normal Message 15,68 
Functional Relationships 2 
Functions 

AppUcation Programming 3 

Machine Operations 2 

Systems Operation 2 

Systems Programming 3 

Generation, Data Base Description (DBDGEN) 96 
Generation, Program Specification Block (PSBGEN) 97 



114 



History 1 1 

lAM Command 12,67 

Initial Program Load 8, 13, 73 

Input Formats, Remote Terminal 15 

Integration, Application Data, Data Base Concepts 9 

Introduction 1 

IPL 8,13,73 

JCL 

DBD Generation 97 

PSB Generation 97 

Security Maintenance Program 97 

System Definition 98 

Type Region 83 

Type 2 Processing Region 83 

Type 3 Processing Region 84 

Keyword 16,17,54,55,70 
Definitions, Master Terminal 16 
Definitions, Remote Terminal Command 54 
Synonyms, Master Terminal 17 
Synonyms, Remote Terminal 55 

Labels, Log Tape 14 

Language, Command 12 

Language, Master Terminal Command 16 

Library Procedures 76 

LINE 17,54 

Line Logical Terminal 12 

Logical Terminal 12 

Line 12 

Subpool 12 
List of All Terminal Commands 1 2 
Load, Program, Initial 8, 13, 73 
LOCK and UNLOCK Commands 56 
Log 

and No Log Commands, Data Base 12, 52 

Command 12, 64 

Manual Shutdown 91 

Reported Remote Terminal Failures 72 

Tape, IMS/360 94 

Tape Labels 14 
Logical, Physical, Terminals 12 
Log Tape 94 
Log Tapes, Record 94 
LTERM 12,17,54 

Machine Operations 

and IMS/360 8 

Checklist 4 

Function 2 

Readying, for IMS/360 73 
Maintenance 

and Failure, Data Base 91 

Normal, Data Base Dump 92 

Program, Security 97 
Master and Remote Terminal Commands (see "Commands") 
Master Terminal 10,11 

and Console Messages 109 

Command Keyword Definitions 16 

Command Language 16 

Commands 16 

Commands, Correction 16 

Operation 15 

Keyword Synonyms 17 



NuU Words 18 

Syntax 18 
Message Processing Region ABEND 13 
Message Scheduler 10 . 
Message Switching Format / 69 
Message and Codes 100 / 

Messages, Console and Master Terminal 109 
Multiprogramming Environment, OS/360-IMS/360 8 

Network, Switched 12 

No Log, Log Commands, Data Base 12,52 

Normal Message Format 15,68 

Normal Restart 85 

NRESTART Command 48,85 

Null Words, Master Terminal 18 

Null Words, Remote Terminal 55 



Operator Considerations, 2260 71 

Operator, Master Terminal 1 5 , 70 , 94 

Operator , Remote Terminal 15,71 

Operating System/360-IMS/360 Multiprogramming 

Environment 8 
Operation, Master Terminal 15 

Pl,P2,etc. 17,55 

PASSWORD 16, 69, 70 

Physical and Logical Terminals 1 2 

POLLING 71 

Procedure Library 76 

Processing 

Batch, Teleprocessing 9 

UtiUty Programs 96 

Message, Region ABEND 13 
Processing Regions 

and System Flow 10 

TypeO 10 

Typel 10 

Type 2 10 

Type 3 11 
Process Stop Commands 12,24 
PROGRAM 17,54 
Program Load, Initial 8,13,73 
Programming, Application, Function 3 
Program, Security Maintenance 97 
Program Specification Block Generation (PSBGEN) 97 
PSBGEN, Program Specification Block Generation 97 
PSTOP Command 12,25 
PTERM 12,17,54 
PURGE Command 12,25 



RDISPLAY Command 11,12,66 
Readying Machine Operations for IMS/360 
Record of IMS/360 Log Tapes 95 
Recovery, Data Base, Command 12, 93 
Recovery from Failure, Data Base 91 
Region ABEND, Message Processing 13 
Regions, Processing, and System Flow 10 
Remote Terminal Execution 54 
Remote Terminals 13 

Command Keyword Definitions 54 

Commands 54 

Corrections 54 

Input Formats 15 

Keyword Synonyms 55 



73 



115 



Language 13,54 

Log of Reported Failures 72 

NuU Words 55 

Startup 68 

Trouble Procedure 71 
Reports, Statistics 96 
RESET Command 12,66 
Restart Command 1 2, 47, 84 

Checkpoint Relationship 85 

Emergency 88 

Facilities, Checkpoint 10 

Normal 85 

Types 84 

Types, Sequence of Events 86 

Scheduler, Message 10 

Security Maintenance Program 97 

START Command 12,20 

Starting IMS/360 75 

Startup, Remote Terminal 68 

Statistics Reports 96 

STOP Command 12,20 

Stopping IMS/360 89 

Stop, Process, Commands 12,24 

Subpool Logical Terminal 12 

Switched (Dialup) Terminal Startup 70 

Switched Network 12 

Switched Network, Remote Terminals 70 

Syntax , Terminal Command 55,18 

System Definition 98 

System Execution 73 

System Flow, Processing Regions 10 

Systems Operation Function 2 

Systems Programming Function 3 

Tape, Log, IMS/360 94 
Teleprocessing and Batch Processing 9 
Terminal Commands, Master 15 



Correction 16 

Keyword Definitions 16 

Language 16 

NuU Words 18 

Syntax 18 
Terminal Commands, Remote 54 

Corrections 54 

Keyword Definitions 54 

Keyword Synonyms 55 

Null Words 55 

Syntax 55 
Terminal Input Formats 15 

Command Message 15 

Message Switching 15 

Normal Message 15 
Terminal, Master 10, 11 

Keyword Synonyms 17 

Null Words 18 

Syntax 18 
Terminal Operation, Master 15 
Terminal, Remote, Trouble Procedure 71 
Terminal Startup 68 
Terminal Startup, Switched (Dialup) 70 
Terminals, Physical and Logical 1 2 
Terminals, Remote 54 
TEST Command 12 
TRAN 17,54 

Trouble, Procedure, Remote Terminal 71 
Type Processing Region 10 
Type 1 Processing Region 10 
Type 2 Processing Region 10 
Type 3 Processing Region 1 1 
Types of Restart 84 

UNLOCK, LOCK, Commands 12,54 
Utility Program, Processing 96 

VERB 16 



116 



SH 20-0636-1 



00 

CO 
0) 

o 
O 



o 

•o 



International Business Machines Corporation 
Data Processing Division 

112 East Post Road, White Plains, New York 10601 
(USA only) 

IBIVI World Trade Corporation 

821 United Nations Plaza, New York, New York 10017 

(International) 



READER'S COMMENT FORM 



IMS/360 for IBM S/360 Operations Manual 
Volume II - Machine Operations 



SH20-0636-1 



Please comment on the usefulness and readability of this publication, suggest additions and 
deletions, and list specific errors and omissions ( give page numbers ) . All comments and sugges- 
tions become the property of ibm. If you wish a reply, be sure to include your name and address. 



COMMENTS 



fold 



fold 



fold 



fold 



• Thank you for your cooperation. No postage necessary if mailed in the U.S.A. 
FOLD ON TWO LINES, STAPLE AND MAIL. 



SH20-0636-1 



YOUR COMMENTS PLEASE... 

Your comments on the other side of this form will help us improve future editions of this pub- 
lication. Each reply will be carefully reviewed by the persons responsible for writing and pub- 
lishing this material. 

Please note that requests for copies of publications and for assistance in utilizing your ibm 
system should be directed to your ibm representative or the ibm branch ofiBce serving your 
locality. 



fold 



fold 



FIRST CLASS 

PERMIT NO. 1359 

WHITE PLAINS, N. Y. 



BUSINESS REPLY MAIL 

NO POSTAGE NECESSARY IF MAILED IN THE UNITED STATES 



POSTAGE WILL BE PAID BY . , 

IBM Corporation 
112 East Post Road 
White Plains, N. Y. 10601 







o 
O 



Attention: Technical Publications 



fold 



fold 



International Business Machines Corporation 
Data Processing Division 
112 East Post Road, White Plains, N.Y. 10601 
[USA Only] 

IBM World Trade Corporation 

B21 United Nations Plaza, NewYork, New York 10017 

[International] 






